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Editorial 

Thank you lo ihose who responded to the 
request lor help with utilities. *e have 
Roger Harris's programming aid "Lister" in 
this issue. It any more of you want to tell 
us about your favourite utility - either one 
you have written yourself or a commercial 
one - please whip in. You don't need to 
write a lot, just what it does and why you 
like it. 

I also have some books tor review, two on 
Visiralr and one each on the Apple /// and 
CP/M. Any takers? 

Unfortunately, the Expert Systems article 
has had to be held over again but it will 
appear in the next issue along with a review 
of a commercial Expert System. 

Do remember (hat the copy date for the 
Christmas edition is earlier than usual. Please 
get your items in by October 26th. We expect 
to put our a bumper edition then but this 
docs not mean that there will be space 
waiting for late entries. Please will all 
those who currently have books or other 
items for review ensure that these are 
reviewed for the next issue or that, where 
this is not possible, you have let me know. 
Most of the people who donate their products 
for review want lo se« them reviewed for 
Christmas. Try not to let them down. 

W ANTF.fl 

Have any of you longed for a chance to be 
the first so read what goes in Hardcore? 
Well, here is your chance. We are looking 
for a new editor of Hardcore to take over 
from the end of the year. The job is not 
difficult but does take up quite a lot of 
time particularly in the fortnight following 
copy dates. Anyone willing to take on the 
job will be given the opportunity to see the 
Christmas edition produced and will be given 
lots of help and support during the 
production ot their first issue il they need 
it. Anyone who wishes to apply or to ask tor 
further details should telephone Bob Raikes 
on u>2> £70621. 

Lonely Apple 

The following member would like to get in 
touch with people who use Apple T* or 
U-computers in Norway: 

iifniiHIiW' 

jjyyytutfiffl 



Chairman'/ Corner 

Our new committee members are now finding 
their feet, and progress is being made. 
Volunteers in the Software group are 
Currently working on moving the Software 
library from DOS 3.2 to 3.3. The machine 
Code course in October will happen, and a 
Logo course is promised. Mid-Apple are 
hosting a meeting with help from Richard 
Boyd on Communications, and there are > new 
releases in the Special Release Software 
series in the course of preparation^ 

There have been 2 moves of note. Pran Teo 
has moved recently, apologies if there has 
been any delay in meeting orders etc. Those 

who know Fran will realise how unsettled her 
circumstances have been. We wish her the 
best of luck in her new home. 

The Bulletin board has also moved. Its 
founding fattier Quentin Reidford has taken 
the plunge in trying to go commercial. There 
is a board still on his number, but it is no 

longer the 5ASUG one. Tony Game has taken 
over the board, and Peter Irinder has 
stepped into his shoes as Press Officer. If 
you have any news that may be of interest, 
or an unusual application lor your Apple, 
please lei him know. 

As you will see, Yvctte is relinquishing her 
position as editor of Hardcore after the 
next issue. We are urgently looking for 
someone to step into the breech. Anyone 
interested should contact myself, Norah 
Arnold or 3im Panks. There is a great deal 
ol work involved, but the job is rewarding 
in the personal and financial sense. Apply 
NOW. 

At BASUG we aim to he both amateur and 
commercial. If our standards occasionally 
fall below those that both you expect and 
that we expect of ourselves, please let us 
know. Remember BASUG is run on YOUR behalf. 
If on occasion we seem not to be acting with 
this in mind, please let myself or someone 
else on the committee know. 



WARNING. 

There have been problems with the 64k 
Printer Buffer Card from Peanut. It wouldn't 
work with Visicalc or Logo. Peanut have 
offered to fix it. Anyone else had any 
problems? 



Apple users need Hardcore to do it. 



October 1984 HARDCORE - The Journal of the British Apple Systems User Group Page 5 



PORTH 

A Ouick Introduction to Forth on the APPLE 
by Hugh Dobbs 

Newtown School* waterfocd, EIRE. 

The computer package supplied to schools by 
the Depart mem nf Education included a 
variety ot languages: four versions of 
BASIC, Comal, Pascal, 8080 Assembler, 6502 
Assembler, PILOT. This paper is a brief 
argument in favour ot one language which was 
noi included: Forth. 

I have used BASIC extensively, especially 
APPLESOFT; it is an easy language lo write 
in, and mistakes take little time to correct 
if you can find ilicm, but most versions lack 
any structure more advanced than a 
subroutine, and most arc interpreted and 
therefore slow. 

1 have used Pascal; in it, program 
development is much slower since it is 
compiled and there is a lot ot time spent 
switching between compiler and filer, 
reloading source code and editing it, and so 
on; Pascal programs can be highly structured 
and, being semi-compiled, run fairly last. The 
UCSD version of Pascal also has the 
advantage of being portabJe over many 
different computer systems. The language is 
however fussy in the punctuation it requires 
and in the need for the declaration of data 
types and so on. 

I have also used 6502 Assembler language 
extensively. It is very hard to get things 
right in it; it is unstructured and has none 
of the features of higher-level languages; 
but it is very fast indeed when running. 

Somewhere in the middle, ther e is a need lor 
a compromise, especially in applications 
where computers control machinery; you need 
the system to be able to make decisions 
quickly, but also you need to know what each 
part of your program docs and to be able to 
change sections of it easily without 
affecting others. One suitable language is 
Forth, which is fast but structured, 
combines the case oi a high-level language 
with the speed of machine code (very 
nearly), is both an interpreter and a 
compiler, and is available on a wide range 
of systems. 5ince versions of it are in the 
public domain most Forth systems are fairly 
cheap (often under t50), and there is a 
fair degree of standardisation with only two 



•najor dialects and a few eccentric versions 
which conform to neither. 

The version I use on the APPLE is from the 
Forth interest group in USA, written by 
Kuntze but typed in and assembled by me, and 
it still has bugs in it but is on disk no. 
in the sottware library if anyone wants to 
try it out. 1 am also using GraFORTH for its 
turtle-graphics, and evaluating Metacrafts 
FORTH which is a powerful and 
well-thought-out version with oveilays. I 
also have Forth running on a BBC machine (r 
q Forth, Acornsoft and the JW6-FORTH ROM), 
on Atoms (Acornsoft), on a ZX-JH (Anir), on 
a Spectrum (HL-FORTH) and naturally on an 
Ace, and I am collecting information ori 
other implementations. 

The APPLF version starts up when its disk is 
booted, clearing the screen and announcing 
"THE tTH APPLE'.", what follows is a 
condensation of what happens In about three 
periods' worth of Computer Studies (whether 
al first year, second year or fifth year 
level). 

Forth, like any other language, has a 
certain vocabulary. Unlike most other 
computer languages, but like natural 
languages, it grows by the addition of new 
words to its vocabulary. The new words are 
defined in terms of the existing words and 
thereafter can be used in exactly the same 
way as the older words - in fact a large 
part of the Forth nucleus is made up of 
words which have been defined in Forth 
rather than in machine code. 

Most words are defined using the Forth word 
[:] (colon). A word in Forth can be made up 
of any sequence of characters which does not 
include a space, an ASCII NULL, or an ASCII 
CR character, and here the word is just a 
colon. By general agreement, when a Forth 
word is likely to cause confusion in a typed 
article (i.e. in an English sentence), it 
may be enclosed in UquarebracketsJ. Here is 
an example of a 'colon definition'; lots 
more will follow: 

: BELL 7 EMIT ; 

Here the colon says *I am going to teach you 
a new word using words you know already*. The 
new word is to be called [BtLL], and the 
colon puts a header into the vocabulary with 
the word's name DELL, a link pointing to the 
most recently defined word before that, and 
an address which directs the interpreter to 
handle BELL as a word which has been defined 
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using [:]. It then turns on the compiler, 
which processes the rest of the line. The 
C7] is not found in the vocabulary, so it is 
construed as a number and stored as such. 
[CMIT] is a word in the Forth nucleus and is 
therefore compiled. The f;J says 'that is 
the end of the definition', and its main 
effect* are to close the new definition, 10 
mark the new word so that it can be found in 
a vocabulary search, and to turn off the 
compiler. The interpreter has then reached 
the end of your instruction, so it prints 
'OK' and waits for you to do Something else. 

If you now type BELL and press 'return', the 
interpreter searches its vocabulary 
(starting with the most recently defined 
word), finds [BELL], and executes it. This 
produces a number 7 which EMIT converts to 
AbCII code / and sends to the current output 
device; unless you are using a pi inter, this 
produces a 'bell' noise on the speaker. 

If you type BELL BELL BELL and press 
'return', the bell rings three times before 
the interpreter responds with 'OK'. 5o far 
the transactions look like this: 

THE ITS APPLE! 

: BELL 7 EMIT ; OK 
BELL OK 

BELL BELL BELL OK 

because the interpreter absorbs your 
•return' without actually starting a new 
line. 

Now that BELL has been defined it is in the 
Forth vocabulary and can be used in the 
definition of further wotds; for example, 
supposing you want to produce seven bells 
you could always type BELL seven times, but 
you can also do 

: BELLS DO BELL LOOP ; 

after which 

7 BELLS 

will produce the desired result and give the 
added benefit of being able in have 100 
BELLS or even 32767 BELLS if you wish, tthat 
happens here is that the DO. ..LOOP inside 
BELLS counts up from to whatever number 
comes before it (7 or 100 or 32?67), and 
whatever lies between DO and LOOP gets done 
so long as the counter has not reached the 
limit. 

Computers are often used tor simulations. Not 
having any special input/output hardware,. I 



go in inr simulated simulations. For 
instance, suppose 1 want to simulate an 
alarm clock or a burglar alarm. When the 
alarm goes off, a hell should ring uniil 
someone does something about it. Something 
which can be simulated by pressing a key on 
the keyboard, for instance. So 1 type 

: ALARM BEGIN BELL 

- il 1 press 'return' at that point the 
interpreter does not tespond with its usual 
•OK' because I have not finished my 
definition yet (no [;] yet). After ringing 
the bell, it slwuld test to spp whether 
anyone has pressed a key 

^TERMINAL 

(or in some versions of Forth ?MSC, etc) - 
this checks and leaves a true-or-false Hag. 
I want the BELL ? TERMINAL sequence to 
continue until the result is true, so 

UNTIL ; 

completes the definition. Now typing ALARM 
will set it off. The burglar alarm type 
would have to be a bit more resistant to 
being turned off, so I might use 

: BURGLAR BtOlN BhLL AGAIN •, 

in which rase BURGLAR will start an infinite 
loop which can only be stopped by a machine 
reset or by turning off the power (don't try 
that until the end of the session!). 

To some extent this illustrates the 
strur hired nature of Forth; tt is worth 
mentioning that any branching construct such 
as DO... LOOP oi BF.C.IN... AGAIN or 
BEGIN. ..UNTIL or IF...ELSL...1 HLN can only 
be used within a colon definition (or 
equivalent), which means that it is 
impossible for branches to occur outside the 
current structure (compare the typical BASIC 
nastiness of GOTO from inside a subroutine 
or from inside a FOR. ..NEXT loop). Also the 
compiler checks the syntax to ensure that 
the branching structures themselves are 
properly constructed. 

Now I want to illustrate something of the 
speed involved. BASIC is relatively slow, 
and probably most people have tried the 
traditional APPLE squawk program 

10 X = PEEK (-16336) :COTO 10 

and know how low a note that produces; even 
the variant 
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10 S * -16336 

20 X = PEEK (S) : GOTO 20 

gives a note which is not high enough to be 
satisfy ingly musical, so most gamp programs 
in BASIC include a machine-code routine lor 

producing notes. Forth is fast enough to du 
it alone (if you don't mind whether the 

notes correspond to actual musical 
frequencies or not). A simple square wave 

output trom the APPLE'S speaker can be 

generated by producing a series of clicks at 
regular intervals, i.e. click pause click 

pause So I dciine 

: CLICK -1633* C£ DROP ; 

Thai defines [CLICK] to produce a number 
-163J6, go and get the contents ol that 
memory address (thus clicking the speaker) 
and DROP that value so as to end up with 
nothing (except a click). 

: PAUSE DO LOOP ; 

Thai is like [BELLS] above, in that >t 
counts up Irom U to whatever number you leed 
it (less 1); but inside the loop it does 
nothing. So 

10000 PAUSE 

says 'go into a corner and count up from 
to 9959'; it takes much less time than 
BASIC'S FOR A ^ TO 9999 : NEXT A. 

: NOTE 100 DO DUP PAUSE CLICK LOOP 
DROP ; 

That defines [NOTE] as a word which does 
something 100 times; what it does is take a 
DUPlicate copy of whatever number it whs 
fed, do that length of a PAUSE, then a 
CLICK, and loop back again so that it 
produces 50 complete wave cycles at some 
unknown frequency. 

I MOTE 

produces the highest possible note of this 
type, and 

I NOTE 2 NOTE 3 NOTE 

will give a descending pattern. Wc can build 
up a Scale' by feeding a decreasing 
sequence of numbers to NOTE: 

: SCALE 20 DO 1 NOTF. -1 *LOOP ; 

Here [I] is a word which gives the value of 
the loop counter (to feed to NOTE), and 



since we wane to count backwards I have to 
use [-1 tLOOP] which says 'count down 1 at 
a time', rather than simply LOOP. Now try 
SCALE .... then 

: DOWNSCALE 21 I DO I NOTE LOOP ; 

SCALE DOWN5CALE SCALE 

and su on. It is not very musical, but great 
fun to experiment with. Further words can be 
built up using these, such as 

: PRACTICE BbGlN iCALt DOWNSCALE 

^TERMINAL UNTIL ; 

- the effect of that should by now be 
predictable. Ot 

; WHISTLE BEGIN CLICK AGAIN ; 

(but only at the end ol the session - why?). Or 

: SQUEAK 1000 DO 1 PAUSE CLICK -I 
.-LOOP ; 

etc. probably ad nauseam. 

You can work in whatever number-base you 
like. There have been numerous BASIC 
programs pubiished in the various computer 
magazines (probably at least $00I*i of them) 
to convert numbers from hexadecimal to 
decimal or vice versa, but in Forth it is 
very easy: 

DECIMAL 120 HEX . 

will give you 78 OK', where $78 is the 
equivalent of the decimal number 120. 
[DECIMAL] sets the number-base to ten, and 
in nearly all Fortli versions [HEX] sets it 
to Sixteen. If you have a lot ot conversions 
to do, you can define a word 

: TOHEX BASfc & HfcX SWAP D. BASE ! ( 
120 TOI1EX 

This will give you '78 OK' if you started 
off in base ten, but if you tried it 
immediately after the previous example it 
gave you '120 OK* because you were already 
in base sixteen. What happens i* this: [BASE 

0] gets the present number-base, [HEX] sets 
the base to sixteen, SWAP lets you get at 
the number you wanted to convert, and [0 D.] 
prints it as an unsigned number in the range 
0-FFFF. If you wanted a signed number from 
-8000 to *7FFF you could use simply [.] 
instead. Finally [BASE !J restores the old 
value of number-base. This word will now 
convert from any number-base that you care 
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to use into hexadecimal. 

The two standard number-bases are base ten 
and base sixtcenj but supposing that you 
want to use base two, perhaps (or making 
shape tables or for displaying the processor 
status register or the state of an eight-bit 
input port, you can define 

: BINARY 2 BASE ! ; 

ant) now [BINARY] will change the number-base 
to two. So 

DECIMAL 99 DUP HEX . BINARY . 

will give '63 110001 1 OK', in other words it 
takes the decimal number 99, makes a 
Duplicate copy of it, and displays it tirst 
in hexadecimal and then in binary. It leaves 
you in binary, so that typing 

99 

will give '99 ? MSG 0', which means 
■unknown word*, since [99) Is neither a 
Forth word nor a number in base two. 

It is easy to develop simple control 
programs or "applications' as they are known 
in For th. tf for instance there is a 
Digitalker card in slot 2 of the APPLE, the 
following makes it produce its complete 
range of words and noises: 

HEX 

: TALK 90 DO ICOA0G1 

BEGIN C0A0C@ 2 MOD UNTIL LOOP j 

TALK 

That counts from up io the range of 

values that Digitalker translates. It puts 
each value in turn into the Digitalker 
output register at SCOAO ($C0B0 for slot 3, 
etc.), which starts the noise. It then 
enters a loop which scans Hie Digitalkei 
status register (also at $C0A0) until the 
Lowest bit becomes a 'J', which indicates 
that the noise has been completed and it can 
go on to the next one. 

The current disk version of Kuntze's 'fcTH 
APPLE!' is available lrom the sottware 
library and includes demonstration screens 
on noises, a simple drawing application, the 
fig-Forth screen editor (use with care), a 
decompiler which handles most 'normal.' 
words, a tew utility words, an assembler 
which is licenced for educational 
distribution but which is insecure, nod a 
special vocabulary which allows Forth to 
read and display the time using a Glanmirc 
filpcironics Micro-Watch. It is public domain 



boltware, meaning that you may copy it and 
distribute it further if you wish (RUN NOTES 
first for a notice to this effect) at your 
own risk! There is one known bug in the 
current issue: DR0 and DR I do not do exactly 
what one would expect... also be warned that 
pressing reset at present kills DOS. If this 
matters (FORTH only uses RwTS itself) you 
can do 

MON 

•3EAG (reconnect DOS) 

•6104G (warmstart FORTH) 

If you have the disk, 

12 67 INDEX 

will give you an idea ol what screens are 
available; 

12 LIST 

will display the contents of screen 12, 
while 

1 2 LOAD 

will actually carry out the instructions on 
that screen. All screen transactions should 
be done in DECIMAL. 

Before you do anything, make a copy of the 
disk using the COPYA or COPY program from 
your system master disk. The disk VTOC has- 
been fixed so that all tracks up to track 17 
(the CATALOG and VTOC track) are marked as 
used, so that any Forth screens (12 to 67) 
will be copied along with DOS and with the 
normal DOS files that occupy the latter hall 
of the disk. 1 can supply an editor manual 
if needed - no room on the disk. 

For those who want a more advanced package 
there arc at least five other Forth 
implementations for the APPLE: KuntZC liaa an 
extended version, Cap'n Software has one, 
Transforth is extended in various directions 
including maths, Metacrafts is powerful but 
1 don't know much about it yet, and CraHORTH 
is a very powerful graphics and music 
language which supports recursion and allows 
the creation of 'autorun' packages but lacks 
some of the flexibility of the others (but 
it has to be seen and heard... and it is not 
too expensive either). 

For those with other lig-FORTH systems, the 
only thing above which will need changing 
(apart from the Digitalker section) is 
CLICK. Refer to your system manual for 
information on how to click the speaker; you 
will probably have to TOGGLE one hii of an 
output port. 
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Small Pel/ 



U/cr Ho/til ity 

Why User friendly? 



by Bob Raikcs. 

Don't those patient, ever calm people who 
never get excited or angry drive you mad? 
They do me. 

How much worse it is when a dumb machine is 
the same. Such patience. However many times 
you put the data disk in instead ot the 
program disk, that fldming machine simply 
beeps, displays 'Insert Program disk and hit 
any key to go on' and waits patiently. 
Absolutely maddening. 

1 would like lo make a pled lor user hostile 
programs. No more endless prompts and quiet 
patience. How about the sound of a 
raspberry, followed byz- 

"Are you stupid or something? 1 said the 
PROGRAM disk, you idiot". 

Then if you repeat the mistake:- 

"I've told you once. Put the P R G R A M 
disk in now. Come on, I'm waiting". 

If you make the mistake again, the program 
would initialise the disk, leaving only a 
file called "SERVES YOU RIGHT' and a screen 
display of 'DAMN HUMANS'. 

No more of this simple prompt such as a ? 
Replace this with 'WELL??' and the sound of 
a tapping foot. 

Some programmers have come to these same 
conclusions before me 1 am sure, and have 
worked on some very subtle ploys. The most 
user hostile program I have met is an old 
version of Computer Ambush. After 10 hours 
playing (25 inins per torn!), it crashed and 
destroyed the game when I tried to save it 
with 'DISK FULL ERROR'. Anybody got any 

other nominations? 



Quick Tip 

by R. C. Lowe 

CONTROL CODE SPOTTING 

If you want to know if the name of a file on 
disk contains a control code try CATALOGing 
while in INVERSE mode, it wont tell you what 
the controi code is or where it is but it 
will tell you how many (if any) are in the 
name. 



For Sale: 

<»8k ITT 2020, Applesoft in ROM, two ITT disk 
drives with controller, Ferguson IV B&W TV, 
Parallel printer card with additional 
circuit to drive V24 serial, Transdata M)0 
thermal primer with keyboard, paddles and 
games. L500. 

Contact; Alan Duerdcn, ifyfjKiliUNitHI' '1^!' 

**»«*»*»**»«« «ftN*«**««*ft**»««««l|**»N*ft»«** 

Apple 1* 64k, two disks, colour card, 
Centronics parallel card, paddles, dors, 
etc. 1 800. 

Contact: Derek Page on ui >.<>■ during 

office hours. 

«,.,.,,».,*,......»..■.*.,,,«,,,»,,,,,,.,,»,. 

Apple I disk drive * controller 1 1 60 

APS 9 11 monitor t25 

Various games in mint condition all at half 
price. 

Ring David Girdler on i.iufM=> wm^*\ l\W ■> 
■ ■ ■ during office hours, 

Neptune 6ftk Extended 80-column card for 
Apple //e. 1 100 o.n.o. 

Ring Brian P on I ton on > »r»i k#*'ih<h 



EDUCATIONAL/GAMES SOFTWARE 

Approximately 25 packages, used once 
in original boxes with all documentation 
normally only for sale in the United States 
and worth about £700 

need Apple ][, ][+, Applesoft 48k. DOS 3.3 
//e, disk drive or Franklin Ace, disk drive 

£100 the lot or will split 

Contact: James Nalty, ' ...... .. .,, 

f14.ii.. lifetHi -mi. i jinn tfmttfijtti 



Mathematicians do it with tables. 
Software Engineers do it in bits. 
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Software Review 

Apple Assembly Language Course 
Prieei fclWti 

Suppliers: Honeyfolrl Software Ltd. 
Standfst House, Bath Place 
High Stieet, Darnel, London EN5 1ED 

Reviewed by Scth Proctor 

This "course" comes in a video-cassette type 
box, consisting of a 5 l/<* inch disk and 
book. The disk holds the assembler, which 
may be used on any Apple I or on a //e, and 
a "tutorial"; the book, meanwhile, explains 
the codes oi the Apple's processor chip - 
the 6502 - with various appendices having 
useful tables which are vital to 
programming, but what is "assembly language" 
and the "6502"? 

ASSEMBLY LANCUACL. 

As most of you may be aware the Apple comes 
with q standard language - BASIC, or 

Applesoft. The main advantage of this 
language, believe it or believe it not, is 
that it is easy to read and to understand 
with its instructions being raiher Like 
English, and therefore relatively easy to 
use. So lo print something one would key in 
•WIN I ..."; to go in a loop ten times 

FOR X = I TO 10 ...NfiXTX 

and so forth. However, this is not the 
language of the computer, for it is, putting 
it very simply, a collection of switches 
(which may be on or oft) with those which 
run and control the Apple on a special kind 
of chip - a processor chip called the O02 - 
and everything has to be scaled down to 
this level. So, for example, ftASIC programs 
are decoded into a format which the computer 
can understand - that is machine Code. So, 
obviously, it would be better to write 
programs in machine code to cut out the 
decoding. Therefore why not wiile piogiams 
in this code? Because it is a laborious task 
whereby everything, as 1 said earlier, has 
to be scaled down, or decoded, by the 
programmer before writing the program, tven 
a simple PRINT sidtement requires a lot of 
work, so a compromise has to be reached 
between legible languages like BASIC and the 
Illegible machine rode. This is assembly 
language, whose prime advantage is speed, 
for there is a closer relationship between 
assembly language and machine code than 
between BASIC and machine code. It one, 
therefore, wishes to write programs where 



speed is the name of the game (e.g. animation 
or fast sorting), then one has to purchase 
an assembler which allows a user to write 
piugrauis in assembly language and to decuu*e 
them into machine code. The Apple Assembly 
Language Course by Malcolm whapshott in the 
Di Watson series is one which is available 
and under review now. This review - done 
with a y/e - is split up to cover the 
package's four components - the course, the 
tutorial, the assembler and the package 
itself. 

THE COURSE. 

This makes the assumption that those reading 
the book have no prior knowledge of assembly 
language, so a "softly-softly" approach is 
given and maintained throughout. Thus one 
starts with an in tioduc tut y chapter on 

understanding the language, and machine 
code, as well as understanding and writing 
instructions. Thence to the introduction and 
on through the various chapters ol more 
concepts which are needed to write progianis, 
including the necessary understanding ol 
binary and hexadecimal numbers, so that by 
the final chapter one should be proficient 

in writing machine code programs with the 
assembler and knowledgeable about the 
built-in subroutines on the 6*>02 chip, whether 

the course is tast or slow, is debateable. I 
will admit that I found it slow, but I must 
point out that 1 have done work in assembly 
language (albeit three years ago on an ICL 
mainframe). Howevei, I maintain that 
slowness is nothing like as bad as a fast 
breeze through, because the subject is quite 
complex if you are a complete novice at 
working in machine code/assembly language 
you need to take your time and not get 
da?7led and overcome by computer science. 

THE TUTORIAL. 

The disk tutorial consists ol two main parts 
- questions & answers and a "counter" 
facility. The questions mainly ask the user 
to calculate the equivalents of given 
numbers in various bases - for example 
binary coded decimal to decimal, decimal to 
hexadecimal, etc., though not, say, binary 
to hexadecimal, which may be needed by some 
users. Thc$c are in addition to the 
descriptive text and a few questions k 
answers in the book. As regards the 

"counter" facility, this is a very 
rudimentary, basic facility which has. rows 
of numbers in boxes which are in two sets - 
decimal, binary & binary coded decimal, and 
decimal, binary & hexadecimal. The objicct ot 
the exercise is to see what happens if one 



Elite 

Software 

Company 



93 Eastworth Road 
Chertsey, Surrey 
KT16 8DX 



Telephone: 09328 67839 



R AMV1 EW 



This Is Elite's own 80-column card for the Apple //e. It Is completely 
compatible with Apple's own 80-column card. The only differences are the 
price and the fact that our board can be upgraded to be a 64K/ 80-column 
card by simply plugging In 8 chips. 



RAMVIEW may also be purchased from Elite Software as an upgraded 64K 

board. 



RAM VIEW Is supplied with an instruction manual, Is fully tested before 
despatch and Is backed by Elite Softwares full one year's warranty. 



The price Of a RAMV1EW Is £60 * VAT (£69). 

The price of a 64K RAMVIEW Is £120 ♦ VAT (£138). 



Postage and packing Is free! * 



taittr i-HilrlH wilr»»tJ. 

Appli h ■ tr-dtrart of Appl. CompuUr Inc. 
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'A'dds or 'Vubracts irom the decimal 
number, which, incidentally, may be started 
between and 99 with the first set of boxes 
and between and 255 ior the second. Mcthinks 
ii was unwise of the programmer not to allow 
negative numbers in the boxes. That is to 
say if one has a display then when I is 
subtracted the display goes to either 99 or 
2i> with the appropriate equivalents given. This 
could be confusing, I hope that this will be 
changed. 

THE ASSEMBLER. 

The course's assembler is very adequate and 
allows the user to enter, list and run 
assembly language/ machine code programs, as 
well as to insert spaces and to move code. 
Subject to my notes in "The Package" below I 
must admit to being disappointed with the 
assembler for various reasons:- 

1) When entering assembly code labels may be 
inert ro refer to a particular section of 
memory. However, upon leaving this facility, 
the assembler changes these into their 
memory locations. So, for example, if a 
section of code is called LOOP1 and a screen 
location defined as POSITION 1 then the entry 
may look like 

LOOP1 STA POSITION1 

I 
I 

J MP LCOP1 

However this could be changed to 
773 STA 102ft 



J MP 773 

This, I feel, defeats the main purpose of 
using such labels - to read the listing 
easily without necessarily having to refer 
to peripheral codes or text. True, they help 
the programmer in writing the code, but how 
about reading it some time alterwards? This 
is especially so with large programs which 
use many subroutines. For example, one may 
remember that POSITION! is the first screen 
location, but not 102ft, and so forth. 

2) My second disappointment was that to 
insert code, say omitted in the entry 
facility, the programmer has to lirst 
calculate how many bytes are needed, then 
insert the appropriate space using the 
insert facility, thence back to the entry 
facility to enter the relevant code. All 
very cumbersome and time consuming, and I 



certainly iound that for small programs it 
is better to start from scratch. An 'add' 
facility would have been far better. 

3) The assembler does not allow the user to 
have comments with the entered code, which 
is a great shame as machine code/assembly 
language programs are sometimes long and 
difficult to follow. (Having said that 
please sec "The Package" below). 

These apart, as I said, the assembler is 
okay and has added facilities, as one would 
expect, to save and load programs (though 

only using drive I) and to go in and out ot 
monitor. The only problem 1 encountered 
using these was that they were not described 
in a clearly marked section, which in the 
event was fairly late in the book; it may 
have been better to have a 'help' facility 
on disk <to be printed to screen or paper) 
or, as 1 said, a clearly marked section in 
the book. 

THE PACKAGE. 

I must confess That I was disappointed with 
the overall packaging ot the course. In the 
book there were a great number of misprints 
and dropped lines (normally after subscripts 
like 2 n A [ft* ^ lso lower-case inputs 
are not possible despite there being two 
assemblers - one each for the I and lie. This, 
1 feel, devalues the course as many lie 
products recognize the existence of lower- 
case characters and cater accordingly. Another 
problem encountered was the fact that only 
drive I may be used, which is fine until one 
exits the assembler and subsequently wishes 
to re-RUN it. It needs a program on the 
course disk in drive I, otherwise the 
assembler program crashes. In short one has 
to go through the irksome task of ensuring 
that the right disk is in drive 1 - the data 
disk when loading/saving programs or the 
course disk when wishing to RUN the tutor oi 
assembler. Another commemt to note is that 
the book is not spiral-bound - unlike Apple 
manuals - which may be disconcer ling fur 
some users; I am told that this would raise 
the price to an unacceptable level, so this 
is lair enough. Furthermore there are no 
reference cards supplied - these, I feel, 
would be of great benefit as at some Mages 
of the course I was referring to a 
program/exercise, the solution, the Apple 
character-set and the Apple screen 
locations. For ease of referral the last two 
could be given on cards as well as in the 
given appendices. (Such "cards" need not 
necessarily be expensive stiff card, a 
pull-out section could do). 
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However, 1 have reviewed the First 
Edition of the course, and by the time this 
reiew is printed a second edition should be 

lor sale (or be imminent). This has, so I am 
promised, no misprints or dropped lines and 
does allow for comments in the assembler. As 
regards my other comments these arc being 
considered lor future editions. In short ihe 
publishers are very much aware ot the need 
to continually improve their wares, so the 
second edition should be far better than the 
first - if so then the product has been 
greatly uplifted and should not collect dust 
on seller's shelves. (A note to our 
continental members: The second edition, 
unlike the first,, will be available on the 
continent. Questions of where, please, to 
the publishers). 

SUMMARY. 

On the whole the course is good 
value-for-money, and is an inexpensive 
introduction to the complexities of assembly 
language. However, I would imagine a 
would-be serious programmer may have to 
invest in a more versatile assembler which 
would give the useful aids mentioned above, 
although nnt only would ii be wist? lo see 
the latest edition before looking elsewhere 
but it may be best to buy this course in any 
case to make sure that assembly language is 
for you. 

mac note 

by P. Knight. 

MICROSOFT MULT1PLAN FOR APPLE MAC . 

For; Very powerful when "opened". 
63 columns wide (10 char. cols.). 
255 rows. 
Editing quite good. 
Display very good. 

Against: On opening, displays keyboard 

of US machines. Thus typing on bottom line 
of UK keyboard produces characters displaced 
one key to right AND Return key (L-Shaped on 
UK board) and backspace and spacebar do 
other things! 

Also lor US a "dollar" command will 
globally label all numbers in selected 
column. No such choice for "t". 

How to SUM? Not much good in M'PLAN 
manual. A useful Ruidc which one can 
understand will be found in Cary Lu's "The 
Apple Mac book" - an excellent book quite 
without parallel. 

Lastly, why doesMicrosof t UK documentation 



not include supply of a backup disk. It 
costs t25 foT a replacement disk outside 
warranty. This is the charge also levied by 
Microsoft UK for a backup disk! Surely this 
is a not-clearly-displayed cost which comes 
under the Trade Descriptions Act and of 

interest to Trading StandardsOf ficers. However, 
USA documentation (left in box "in error" 
according to UK office) Tells you how tn get 
it for SI 0. 

01 course, you're still stuck with US 
keyboard - no t sign, etc. Who released 
this package in UK? The program also does 
not recognise dual disk drives asks tor 
Master disk when it is already loaded in 
other drive. 

In returning package to P A P I said that we 
could alter key caps but surely that would 
infringe disk warranty, also that I didn't 
know how to amend program for 2 disk drives 
even if it were possible. 

Where can I get a reliable UK-style 
spreadsheet for Mac which is anglicised for 

2 drives? I have hobby and business 
interests waiting for me to erect a working 
system about 18 cols, by 250 rows (10 char, 
cols). I also badly want a Tele/Address 
package plus 3 - * option boxes so that I 
can sort on name, company, telephone number, 
etc. 

I suggest Microsoft (particularly UK end) 
should "pull up their socks" and read recent 
criticism in US press of their "Word" and 
lack of a Hotline. 

I have just rung Apple USA and they say they 
are not doing a Mac/M'PIan despite their 
C'LOE.DMO.ttOO which 1 ordered. 



DC* ARE! 

There are disk drives appearing on the 
market which use metal positioning bands to 
move the head. On an Apple disk drive the 
track positioning is considerably less 
accurate so in order to ensure consistent 
booting track tends to be fairly wide. This 
means that a disk initialised or copied on a 
metal band type of disk drive may prove 
ditticult to boot on a standard Apple drive. The 
converse does not apply. 



Computer Operators do it in hliifts. 
Database programmers do it with relations. 
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tov Dicfc Monhinick (ujith o Uttlc no 

The followlnit instructions If 
carried out accurately, will allow 
your copy of Applewr-lter //e to be 
modified to enable the NUL 
character (Decimal 0> to be sent to 
your printer. 

NUL cannot normally be sent from 
ApplewriteT* since trip NUL code Is 
not accessible from the keyboard. 
Unfortunately. NUL Is needed In 
many printers (Epson FX80. Taxan 
KP810) to activate functions ouch 
as underscore, super and subscript, 
proportional spacing etc In the 
case of the Canon PW1080 and Taxan 
KPftio near letter Quality (NLQ) 
printers the absence of NUL is 
particularly irritating since It 
without it. the second (optional) 
NLQ typeface cannot be selected 
Ctriere are l tl different NLQ 
typefaces available for the Taxan 

KP810 now! ) . 

The following instructions apply 
only to Applewriter //e. They 
modify the program to enable the 
■Delete' key on the Apple//e 
produce a NUL code wnen in 
•Control-V mode. Delete works 
normally unless Control-V has been 
pressed . 

(This has been printed on a Taxan 
KP010 with the standard and 
-Ltnltc. NLQ typefaces, using; 
Applewriter //e ) 

(General instructions are in 
this typeface, 
fou tvpe tnct tnjitruc.ttnna 
printad in thio typofaca 

1. Hoot your nns 3-3 master disk 

2. Remove the write protect label 
from your Applewriter //e disk. 
Put the Applewriter //% disk, in 
your disk drive and close the 
drive door. 



from Apple UKt) 

3- Now type the following; lineo, 
each followed by the RETURN key. 

BLOAD APWRTJtE 
CALL -151 
1CK2.-KA HA EA BA 
3BBA:BA BA BA BA 
3 DOG 

UNLOCK APWRTJ (B 

BSAVE APWRTJ [E,A$1900 .LS2F5G 
LOCK APWRTJ [E 

BLOAD APWRTJ [F 
CALL-1S1 

1D01:BA BA EA BA 
4Q33:EA EA EA EA 
3D0G 

UNLOCK APWRTJ fF 

BSAVE APWRTJ (F.AS1 900 . LS30D1 
LOCK APWUTj (F 

That completes the 
modification. Fit a new 
wrl te- protect t«r> to your 
Applewriter* diskette. 

Yon should now Boot the Arplewrtter- 
dlok and give it a try! Remember, 
to get the NUL character from the 
Delete key you will need to have 
pressed Control-V first , but as it 
will be par-t of a longer rommanrt 
string for the printer you would 
normally have Uwne uiai anyway* 

Now. a ohort demonstration of what 
can be done Willi a Taxan KP810 now 
thAt we CAn switch typefaces! 



toxan Plain typeface 



luixam <WtQtt Qfl one B ytJBipDsif e 
Baxan «otbic Ippiface 
Toxav HpCCK T+nCSavC! 



faxan Manduri I ting f 



Taxan KPBol d typemea 



Taxan Toll I i|p « f a c m 
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Ep/on DHIOO 

The Epson DXI00 Printer and Keyboard. 
A review by 3. W. Panks. 

Epson have for some years been connected 
with dot matrix printers. These Imve been of 

good quality and reliable. Ihey were 
probably the first company to introduce 
primers at a price that most users could 
afford. In recent months Epson have 
announced many new product. These have 
included computers, printers and plotters. One 
product that has been added to the range lis 
a Daisy wheel Printer called the DXIOO. This 
has been overshadowed by the other products 
and has not been widely advertised. 

The Epson DX100 is in fact a Brothcr- 
inanufactured printer similar to a Brother 
HR15. It is designed to be a low cost, high 
quality printer with dual use as a computer 
printer or a typewriter. It is available 
with either a Centronics or R5232C 
interface. 

The printer is built on a chassis which 
appears to be very strong and is encased in 
plastic which is a similar colour to the 
Apple beige. The top Sifts up to provide 
easy access to the ribbon and daisy wheel. The 
print head is pulled across the platen by 
the usual wire cable type mechanism* It 
appears to be capable of this job and should 
prove reliable. The electronics arc at the 
rear, of the machine under the platen. The 
rear panel has D-type plugs for the printer 
interface and for the optional "keyboard. Also 
provided is a DIN type socket for the 
optional sheet teeder. Dip switches have 
usualy been hidden inside the machine; on 
the Epson they are placed on the rear panel, 
which makes changes to them very easy. There 
are two provided. The first seieus ihe 
language of the daisywheel; the second js 
used to set page lengths. They are well 
documented in. ihc manual. On the front of 
the machine is a group of switches that 
allow Line Feed, Top of Form, Copy, 
Selection of Line and Pitch searings. 

The printer is designed for medium use, and 
.vould be ideal in the home or for lighT 
office use. The print speed is slow in 
comparison with other more expensive daisy 
wheels or dot matrix printers. 1 have timed 
various print times for text and the average 
speed is 1> characters per second. The print 
head is bidirectional and coupled with the 
3k buffer provided as standard makes the 
priming of single pages fairly quick. Longer 



articles take time and if you need the 
computer back whilst long articles are 
printed you will need to acquire a large 
buffer. 

The noise is acceptable providing the 
printer is positioned on a surface that does 
not vibrate, and is solid. I placed the 
printer on a fairly shaky table and the 
machine nearly threw itself on the floor. It 
does tend to shake, although putting some 
foam underneath cuts the noise and shake in 
half. 

The features of» the machine are very good 
and are not found on some that cost well 
over 1 1 000. It wiSl print at 10, 12 or 15 
characters per inch with Proportional 
spacing it required. The appropriate daisy 
wheel will be needed to get the best from 
the different pitches. Double strike, shadow 
printing and underline are also available. Two 
Colour printing can be done when the printer 
is used with a computer; when a keyboard is 
used the red print becomes a corrector 
providing you change the small ribbon. 

The machine has a very useful copy facility 
which uses the 3k buffer to copy documents 
without the computer being tied up. I found 
this useful when writing similar letters to 
many people, and I think that it is cheaper 
than using a photocopier. The letter is 
loaded into the printer buffer and Then you 
use the copy key on the printer to print it 
out. If you run a small business this would 
be useful coupled with the optional sheet 
teeder. 

The printer has a useful top of form key 
which allows you to load single sheets to a 
pre-detei mined position by simply placing 
the paper and pressing the TOF button. The 
next time you press the button it ejects the 
piper. Other commands thai ran he entered in 
off line mode are line spacing and pitch. These 
can also be set by soitware from within 
programs. 

Other featuies include auto underline, auto 
Strike out, super- and subscript, half line 
teed in both directions and the setting oi 
print head movement to 1/I20th of an inch. 
Line spacing can be set to 6, 4 or 3 lines 
per inch by using the front panel or from 
software. The line spacing can be set in 
increments oi I /48th of an inch from 
softwaee, which could make il easy to use 
the printer lor graphics. 

The Epson is compatible with Wordstar and 
uses standard Diablo protocols. I have used 



Page 16 HARDCORE - The Journal of the British Apple Systems User Group October 198 



it with Applewriter 11, Format ISO, Letter 
Perfect, Wordstar and Zatdax with no 
problems. If you wish to use it in 
Piuportional Mode you will have to configure 
your program to the printer. On some this is 
easy, on others it may take some time. If 
you really need proper proportional spacing 
you would be wise to get advice before 
buying any particular program. 

There is an optional extra OS character 
keyboard for the Epson which turns thcDXIOO 
into a super typewriter with all the latest 
fancy electronic typewriter facilities, 
including auto correction. The keyboard 
plugs into the rear of the printer and can 
remain there when the printer is being run 
by a computer; there is an on/off switch on 
the keyboard. The keyboard is a standard 
QWERTY keyboard with optional keyboard 
overlays selected from a switch. This allows 
the use of different daisy wheels. Other 
features included are pitch and line spacing 
switches. The keyboard has adjustable feel 
for angle and this can be set at l>, 10 or 5 
degrees. Some of the keys not normaly found 
on a keyboard are super- and subscript keys, 
correction and relocation keys (used for 
auto correction), express return key (and 
back space) and a code key. The code key 
allows the setting, of decimal tabs and line 
indents. 

The keyboard allows automatic correction in 
the line that you are typing and it also has 
a <»8 character buffer. The keyboard is ideal 
for those thai like myself find belting up 
the computer for text entry a waste of time 
when only a small letter or label is 
required. It also has the tendency to stop 
the wife moaning about spending more money; 
she understands a typewriter but is not 
interested in learning the word proccessor. That 
is the only problem with the keyboard. My 
wife constantly outruns the buffer. It would 
appear that the printer can handle data trom 
the computer quicker than the keyboard. This 
has the tendency to cause major problems 
with fast typists. They find it hard to slow 
down to the speed of the print head and as 
they rarely look at the keys or the typing 
they find that they have lost many 
characters. Howevei I find the keyboard 
excellent but I only type at 20 - 30 words 
per minute. 

As I said previously the machine is really a 
Brother in disguise and therefore Brother 
ribbons and daisy wheels are required. There 
are a lair number of daisy wheels available 
for the DX100 but they are fairly expensive 
at roughly 1 1 8 each. Therefore if you need 



plenty of different types you should bear in 
mind the cost of the daisy wheels. Printer 
ribbons are better priced and you can get 
one for between t3 to U depending on the 
supplier. You can get Single Strike ribbons 
which produce perfect ropy although they 
don't last long and Multi Strike which 
produces reasonable copy but lasts five 
times as long as single strike. Nylon 
Ribbons which are similar to normal 
i yp writer ribbons in a cassette are 
available but the print quality is only fair 
and quickly becomes poor after use. 

The documentation that accompanied the 
printer was adequate without being too 
technical. The machine tested was a sample 
machine and the actual documents supplied 
may be improved on the production model. 

Oilier add-ons include a sheet feeder and a 
tractor unit- These are fairly cheap 
compared to other printers. 1 have not tried 
theni out but if the quality is as good as 
the printer then they would be a good buy, 
providing you can justify their use. 

My conclusions are that this printer is a 
high quality printer at a reasonable price. The 
speed is not very impressive but for a fast 
daisy wheel you will pay a lot more. If you 
want top quality, coupled with medium use, 
without paying a fortune, this printer is 
for you. 

1 must thank EPSON (UK) and in particular 
3ohn Sharp for allowing me to use the 
printer. It has been enjoyable and I will 
now be able to produce an Applewriter 
Glossary lile for the Upson DX100. 

imPORTAflT 

PLEASENOIE 

There are two major telephone number changes 
for BA5UG. Please alter these numbers in 
your books (or wherever you keep them). These 
numbers arc valid as from NO*. 



ADMINISTRATION (Fran Teo) 
Newbury !«ltfH»i 

BULLETIN BOARD (Tony Game) 
Felixstowe .finttui. 
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Quiz Writing 

Writing A Quiz Program In BASIC 

by Hugh Dobbs, Newtown School, waterford 

A number of my students have been seen 
expending great efforts on writing quiz 
programs to baffle their friends; 1 was 
alarmed to see how much oi the work wan 
unnecessary, and tor the past few weeks we 
have had an intensive course on the subject. As 
observed, a typical program would run like 
thisi 

10 PRINT "WHAT IS THE CAPITAL OF 

PRANCE" 
20 INPUT A$ 

30 IF A$ = "PASS" THEN GOTO 60 
<*0 IF A$ <> "PARIS" THEN GOTO 10 

50 PRINT "RIGHT" 

60 PRINT 11 WHAT IS 32 t *5" 

70 INPUT AS 

SO IF A$ b " PASS" THEN GOTO 110 
90 IF AS <> "77" THEN GOTO 70 
100 PRINT "RIGHT" 
110 ETC. . . . 

... I have of course removed numerous 
syntax errors and standardised the line 
numbers, but the uveiall structure b 35 
shown. A little calculation shows that for a 
100-question quiz one would need 500 lines 
of BASIC rodp, including 200 GOTO 
statements, any one of which might be to a 
wrong line number — for example, did you 
notice that line 90 there should end with 
'GOTO 60 1 so that the question gets asked 
again? I call that the Hard-Work Version 
<HWV). 

Cleatly it would be much better if all that 
testing and branching could be done just 
once; so I introduce the Subroutine Version 
<5V): 

iO GOTO IO00 
100 PRINT Q$; 
1 10 INPUT A$ 

120 IF A$ = "PASS" THEN GOTO 150 
130 IF A$ <> R$ THBN GOTO 100 
140 PRINT "RIGHT" 
150 RETURN 

1000 LET Q$ o "WHAT IS THfc CAPITAL 

OF SPAIN" 
1010 LET R$ = "MADRID" 
1020 GOSUB 100 

1030 LET Q$ = "WHAT IS 5 TIMES 7" 
10a0 LET R$ = "iH" 
1050 GOSUB 100 
1060 ETC... 



Calculation here indicates that for a 
100-qucstion quiz you need 307 lines of 
BASIC, with a total of 3 GOTOs; and whereas 
you have 100 GOSUBs they are all identical 
so that any mistyping should be obvious. The 
subroutine is placed ahead of the main 
program for two reasons: tirst, most 
versions of BASIC search through from the 
start of a program for the line number 
addressed by a GOTO or GOSUB (which takes 
longer for later lines in the program), 
whereas the RETURN already has the absolute 
address of the GOSUB which called it on the 
stack and does not have to search for ii; 
and second, when you LIST the program the 
bit that does the work is displayed first, 
which is almost certainly what you want. 

The difference between these two versions, 
becomes more obvious when you get 
dissatisfied with the way the program works 
at present and want to arid facilities to it. One 
obvious deficiency is the lack of scoring. You 
decide to keep a score, which means setting 
up a counter and adding one to it for every 
right answer, and then printing the score at 
the end. On the HwV this involves adding ihe 
following lines: 

5 LET S = 
5 5 LET S = S t I 
105 LET S = S + 1 
155 ETC. . . 

999 8 PRINT "YaiR FINAL SCORE IS M |S 
9999 END 

... for a total of 603 lines so far; The SV 
only requires: 

5 LET S -. 

1*5 LET S = S * 1 

9998 PRINT "YOUR FINAL SCORE IS"; S 

9999 END 

... for a total of 311 lines. But perhaps 
you would like the score to be printed every 
time you get the answer right; to do this 
with the HWV: 

57 PRINT "YOUR SCORE SO FAR IS "j 5 
107 PRINT " YOUR SCORE SO FAR IS "j S 
157 ETC 

... only 99 ot these, -making 7U2; while lor 
the SV: 

I #7 PRINT "YOUR SCORE SO FAR IS » ; S 

... suffices, making 312 in all. 

This looks pretty good, but further savings 
are still possible depending on the 
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abilities of your dialect of BASIC. So far I 
have been assuming a fairly minimal 
Microsoft BASIC, and the two programs will 
run with minor changes on. most machines. 

Some BASICS such as Sinclair and Atom BASICS 
allow a 'computed GOSUB' — that is, they 
allow 'GOSUB <expressiun>' a. well a* 'GOSUB 
<iine numberV. (For the Apple use 
ON...COSUB or one of the & extensions to 
BASIC). With these the whole program can be 
inverted: 

1 LET S - 
20 LET Q = 
30 G05UB 1000 4 Q * 30 

UO IF Q$ <> "hND" THEN GOTO 70 
50 PRINT " YOUR FINAL SCORE IS "; S; 

" OUT OF "; Q 
&0 END 

70 LET 0=0* 1 
&0 PRINT " QUESTION "; Q 
90 PRINT QS; 
100 INPUT A$ 

110 IP A$ = " PASS" THEN GOTO 30 
120 IF AS <> R$ THEN GOTO 90 
I 30 PRINT "RIGHT" 
1 tO LET S = S + I 

150 PRINT "YOUR SCORE SO FAR IS S; 

"OUT OF Q 
160 GOTO 30 
1000 LET Q$ = "HO* MANY CORRECT ANSWERS 

ARE ALLOWED FOR IN THIS TEST" 
1010 LET RS - "JUST ONE" 
I 020 RETURN 

10 30 LET Q$ = "WHAT IF THE COMPUTER'S 

ANSWER IS WRONG" 
10*0. LET R$ - "TOUGH" 
1050 RETURN 
1060 ...ETC... 
a 000 LET Q$ r "END" 
*010 RETURN 

This version has a total oi 3 IX lines, and 
will run more slowly than the 5V, but it has 
an advantage if you are very short of memory 
space: 'GOSUB 100' will take up more memory 
rhan 'RETURN': Sinclair, 5 bytes as against 
I (I think); Atom 5 bytes CGOS.a 1 ) as 
against 2 CR.'); thus saving *t00 ui 300 
bytes on the latter part which more than 
makes up for the extra lines. Of course both 

BASICs mentioned require further lines for 
dimensioning string variables, etc. and the 
Atom will refer to SO rather than 0$ 
Throughout. 

Other BASICS have READ, DATA etc, which 
allow of further improvement: 

10 LET S = 
20 LET - 



30 READ Q$, R$ 

*0 IP Q$ <> "END" THEN GOTO 70 

50 PRINT "YOUR FINAL SCORE IS "; S; 

" OUT OF "•, Q 
60 END 

JO LET Q = Q + 1 

80 PRINT "QUESTION " ; Q 

90 PRINT Q§; 

100 INPUT A$ 

110 IF A$ = " PASS" THEN GOTO 30 
120 IF A$ O R$ THEN GOTO 90 
130 PRINT "RIGHT." 
UO LET 5 = 5+ 1 

150 PRINT " YOUR SCORfc SO FAR IS "| S 
160 GOTO 30 

10 00 DATA "IS THERE ANYTHING TO BE 
GAINED BY USING DATA STATEMENTS", 

"YES" 

1010 DATA "WHAT IS THAT" ,. "BREVITY" 

1020 ETC 

99 99 DATA " END" T "PHEW" 

That brings the total down to 117 lines, 
including the printing of the question 
number which was not part of the first two 
versions. Further spare ran be saved by 

ing more than two DATA items per line, 
1 don't recommend it until the program 
Is fully debugged as the layout used makes 
it very easy to see which question has which 
answer, and to check question number O you 
simply work out QMO+990 and LIST that line: 
Most versions of BASIC will allow you to 
leave out the quotation marks around the 
DATA items, but this can give rise to 
invisible errors as follows: if you type 



1050 DATA what is 7 ♦ 8, 15 

and press the space bar before pressing 
<return>, the instruction READ Q$, R$ will 
pick up what you would expect Cor Q$, but R$ 
will be the three-character string "15 
and the victim who types "15" in response 
will be marked wrong. Incidentally the 
reverse may also apply: if the correct 
answer is "15" then "15 " will be wrong. This 
does not usually apply to spaces at the 
start of a string... Anyway, only remove the 
quotation marks after the program is working 
properly, and only then if you are short of 
space for the later questions. The invisible 
errors can be brought out in APPLESOFT by 

using INVERSE before LISTing the DATA 
section; they can often be produced by 
careless editing. 

finally, perhaps your computer has disks. A 
quiz program is an example ol serial data 
processing, and can easily be rewritten to 
take its input from text files on disk. Since 



but 
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all the disk updating systems I have met 
have been different (!) 1 shall just give an 
example using APPLESOFT and DOS 3.2 or 

10 LET O - 
20 LET S 
30 LET DS = CHR$C«> 

tfO PRINT "WHICH QUIZ WOULD YOU LIKE ' 
50 INPUT F$ 

60 PRINT D$; "OPEN" ; F$ 
70 PRINT D$; "READ"; F$ 
SO INPUT Q$ 

90 IF OS <> "END" THEN GOTO 120 
100 PRINT D$j "CLOSE" 

110 PRINT "YOUR FINAL SCORE IS "i S; 

" OUT OF " ; Q 
IJ5 END 
120 INPUT RS 
I 30 LET Q = Q . I 
I'#G PRINT D$ 

150 PRINT "OUESTION NUMBER "; O 
160 PRINT Q$; 
170 INPUT AS 

180 IF AS = " PASS" THEN GOTO 7 
190 IF A$ <> R$ THEN GOTO 150 
200 LET S - S • I 

210 PRINT "RIGHT. YOUR SCORE SO FAR 

15 *l 5 

220 GOTO 70 

This takes only 23 lines, but ol course you 
still tiave to wine the questions arid 
answers. To do this you can use any suitable 

text-editor, such as the APPLE DOS Toolkit 
editor (BRUN &DASM). Type in question* and 
answers alternately, tmishing up with ENU 

in place of a question! 

WHAT IS BLACK AND GREEN AND READ AM. 
OVER 
>\ VON I TOR 

*HAT IS THE SOUL OF *IT 

BREVITY 

END 

Ooviously this program car. be used with any 
number ol different quizes, simply by 

writing different text files to go with it, 

so it is worth while building as many 
improvements into it as you ran. Perhaps you 
would like the screen cleared before each 
question... perhaps you would like 
unnecessary spaces removed irom answers 
input... perhaps you would like the program 
to present a menu of the quizzes on the disk 
and allow the victim to choose one by simply 
pressing a key... perhaps the victim should 
only be allowed three attempts at a 
question... perhaps the victim should be 
allowed to escape without attempting all 100 
questions... it's up to you. 



String Print 

by R. C. Lowe 

In response to word ft rap by Tony Game in the 
August Hardcore, here is a shorter faster 
routine that does the same thing, when 
compressed, it only uses a tew lines. 1 have 
alterpd this routine rhat I have been using 
tor some lime so that it is compatible with 
Word *rap. 

The only problem that I have found with it 
is that, as it is recursive T it will tun oui 

of stack space il the string to be printed 
is too long or if the line length is set too 

short. 

30 REM STRING PRINT N$ 

UO IF LEFT* <N$,1) " " THEN N$ - 

RIGHTS <NS, LEN <N$) - I): GOTO *0 
50 IF LEN (N$) < PL THEN PR I. NT N$: 

RETURN 
60 5 = PL 

70 FOR PS = PL TO I STEP - I 

&0 IF MIDS (N$,PS, 1 ) * " " THEN S 

i PS: PS - I 
90 NEXT PS 

100 PRINT LEFTS (NS.S): 

110 N$ = RIGHTS <N$, LEN < N$ ) - S) 

120 GOSUb <*0 

130 RETURN 

Software Library 

by Jim Panks 
SOFT* ARE GROUP. 



All 3.2 software disks have now been 
distributed and when they are returned the 
3.3 will be sent out. If you have ANY 
difficulties ring your respective manager, 
the address and phone number is in the 
manual supplied. 

Also:- Any members wishing to help m the 
soltware library should get in touch with 
the software group manager at the P.O. Box 
or ring the number on the back ol the 
membership card. Although we have quite a 
few helpers we will not turn anyone away. The 
more helpers the better. 

NEW DISKS. 



New Software Disks arc being released. These 
will include a very fast disk copy program. Full 
details will be published prior to Christmas. 
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Beginner/' Page 

MORE PEEKING AND POKING 
&y John Sharp 

In the last HARDCORE we began to look at 
PEEKing and POKEing. Beiore continuing it is 
wot Hi a lew minutes to consider how to save 
yourself a lot of work when you have a list 
of POKES to enter into a program. If they 
are in a sequence as is most likely, why not 
let the computer do the work and use a loop 
to do it;- 

10 FOR N = 768 TO 776 
20 READ P 
30 POKE N,P 
W) NEXT 

>0 DATA 1,32,221,221,206,0,3,2*8,96 

It will not have made much less work in this 
case but it will do so when there are many 
more POKES to do. 

Now so far we have been mainly POKEing. How 
can we use PEEK in a program to let us do 
something constructive? One way might be to 
see if you have an APPLESOFT or PALSOFT 
machine, i.e. an APPLE or an ITT2020. One 
way is to look into d location you know to 
be different; lan Trackman suggests location 
62W. If you PEEK (62447) and get a number 
other than then you are running on an 
Applesoft in ROM machine. 

PEEKlng Is often useful to find out other 
things in programs. It could be used to find 
out if you are in FLA5HING or INVERSE or 
NORMAL mode when you want to PRINT a new 
string. This uses the location, we dealt with 
last time. For example:- 

10 X , PEEKC50) 

20 IF X = 255 THEN PRINT "YOU ARE IN 
NORMAL MODE" 

30 IF X = 127 THEN PRINT "YOU ARE 
FLASHING AT ME!! 1 * 

40 IF X = 63 THEN PRINT "YOU ARE INVERSE" 

This may not be a common occurrence but it 
could be useful if you were printing in 
different modes and wished to know which one 
you used last. Another case might be to test 
which key someone had pressed last. If you 
PEEK (-16384) then the value you get will 
get will be the ASCII value ol the key 
pressed. This is iliustiated by the 
following:- 

10 FOR N = TO 1000 
20 X- PEEK( -16580) 



30 IF X > 127 THEN PRINT CHRS(X);: POKE 

-16368,0 

40 NEXT N 

The POKE -16368,0 is to reset the switch to 
read the next character typed in . You could 
use it to see which was the LAST CHARACTER 
typed on the keyboard, or indeed if any had 
been typed in whilst the program was 
running, without having to rely on the key 
being pressed at a specific time when the 
program requests it. 

This suggests the following program for a 
simple reaction timer. 

10 TEXT ; HOME 

20 FOR N - 1 TO RND (3) * U000 : NEX1 
30 PRINT "READY" 

40 FOR N = I TO RND (3) » fcOOO : NEXT 
M) PRINT "STEADY" 

60 FOR N ^ 1 TO RND (3) * 4000 : NEXT 

70 PRINT "GO " 

80 POKE -16368,0 

90 FOR N = 1 TO 300 : X= PEEK ( -1638**) :1F 
X > 127 I HEN GOTO 1 10 
100 NEXT 

110 PRINT "YOUR SCORE WAS ";1000 -N ; 
" CAN YOU MAKE IT LARGER ?" 
120 END 

A lew comments would help those who do not 
understand. Lines 20, 40 and 60 put a random 
delay into the program between each 
statement. The resetting of the keyboard in 
line 80 stups you cheating by pressing a key 
before the "GO" comes up. 

POKING THE Hl-RF.S -SWITCHES . 

Have you ever tried to play a game and found 
instead of the correct graphics page the one 
from the graphics game you played before 
comes up. This is particularly common with 
the Integer games on the Software 
Distribution Library Disks. It means the 
switches are set wrongly for jumping beiweeit 

the various pages. These are POKE switches. If 
you read the APPLESOFT MANUAL it is 
confusing to say the least. An easier 
summary as follows is not foolproof because 
the switches arc interdependent, but it 
usually works. 

POKE -16304,0 ....TEXT TO GRAPHICS 
POKE -16303,0 ....GRAPHICS TO I EXT 
POKE -16302,0 ....GRAPHICS* TEXT TO 

FULL GRAPHICS 
POKE -16301,0 ....FULL GRAPHICS TO 

GRAPHICS & TEXT 
POKE -16300,0 — PACE 2 TO PAGE I 
POKE -16299,0 ....PACE I TO PACE 2 
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POKE -16298,0 ....LO-RC5 SWITCH 
POKE -16797,0 ....HI-RES SWITCH 

The East two are the most relevant ones if 
you have the trouble with being in the wrong 
type of graphics. Just press CTRL-C and type 
in the relevant POKE followed by a RETURN 
and rerun the program. 

THE ESCAPE KEYS AND OTHER EDITING 
FACILITIES" 

If you are a beginner you have probably 
glanced at the REFERENCE MANUAL and 
thought "Yes I'll look at That some other 
time, maybe in a lew years time". Well there 
are some pages you might understand lliat ate 
not in hieroglyphics. For example the pages 
on the ESC codes for moving the cursor on 
pages 3* and Y>. AI though most AUTOS TAR T R OM 
users are laminar with ESC 13 KM they are 
not always aware of the ESC DBAC set. They 
give you similar movements., but with one 
difference. If you press ESC ABCD then the 
next key you press actually works- It is not 
a "get you out of using the ESC key 
sequence". If you are a poor typist and arc 
continually mistyping CATALOG titles, you 
probably use the bJiC I3KM keys to run up the 
Catalog and then along the row with the -> 
key. How many times do you "forget to press R 
for the RUN twice or use some other means of 
gelling oui of the ESC sequence only lo find 
you have typedUNMYHROCRAM and had SYNTAX 
ERROR come back at you. well if you get into 
the habit of using ESC D as the last ESC 
character to move the cursor onto the line 
you want, there should be no such trouble. 

Whilst on such tacilities, do you know how 
to slow down or temporarily stop listings. A 
slow listing can be achieved by typing SPEED 
= 180 or some other number less than the 
normal 255. when you Chen LIST the leiteis 
will come out slowly. The lower the number 
the slower; with SPEED =1 they take a very 

long lime. Remember lo reset to SPEED = 255 
before you run the program. 

To slow the listing down so ihdt a few lines 
come up at a time before stopping, use CTRL 
S. Type LIST and press RETURN as normal, 
then put one finger on the CTRL key and keep 
it there. Then press the S key. Each time 
you press it the listing wilJ either move oi 
stop. In order to get back into BASIC type 
CTRL C. THIS WILL NOT WORK ON AN APPLE 
WITHOUT THE AUTOSTART ROM (including 
the IfT 2020) or if you are listing an 
INTEGER program. 



Cour/e/ 

Following the review of one of their courses 
in the last issue, we have heard from the 
University of Salford. They run three Apple 
II courses; 

The Apple for beginners. 

Getting more from your Apple. 

Machine code programming on the Apple. 

Their next courses run in January, April and 
July 19S5 and during 1985 they are prepaied 
lo offer a discount of tlO per course to 
BASUG members. 

Two books based on the courses are due tor 
publication soon. They are "Getting the most 
from your Apple Il/lle/llc" (Addison- Wesley) 
and "Machine-level programming on the Apple 
11/lle" (Prentice/Hall). There is a disk 
associated with each book. 

For further information please contact: 

Conference Office 
Maxwell Building 
University of Salford 
Salford 
M5 *WT 

Telephone: 061-736 58^3 extension <*<t9. 



Assembly Course. 
BOOK NOW 
for 

APPLE ASSEMBLY LANGUAGE COURSE 
October 2 0th 
County Hall, Central London. 
A tew places still left. 
See separate application form. 



BASIC programmers do it but get it wrong. 
FOKTH programmers do it in reverse (polish). 
BBC Micro users do it down a tube. 
Sinclair users can't do it without peripherals. 
Sinclair users can't do it - lull stop! 



STOCK CLEARANCE 



In order to make room for new stock the following items are offered 
for sale at lowest ever prices. Everything must be sold so any offer 
made will be considered. 

N.B. VAT INCLUDED IN ALL PRICESI 
USED HARDWARE 



APPLE II EUR0PLUS £275 
APPLE DISC DRIVES FROM £145 
CONTROLLER CARD £40 
PARALLEL PRINTER CARD £35 
SERIAL PRINTER CARD £30 
COMMS CARD £30 
DIPLOMAT COMMS CARD £50 
SMARTERM 80-COL €75 
DIGITEK S0-COL£75 
DOS 3.2 CONTROLLER CARD £20 
PAL CARD £25 
ITT 2020 £195 

ITT DISC DRIVE (APPLE COMPATIBLE) 
£125 

MONITORS FROM £35 
VARIOUS PRINTERS FROM £145 
APPLE POWER SUPPLIES £50 
110V POWER SUPPLIES £30 
GAMFSSOCKFT EXTENDFR f4 
ORBIT ACCOUNTS PACKAGE £200 
APPLE II CARRYING CASE £35 
APPLE II CARRYING BAG £5 



COMPLETE APPLE II SPARES KIT INCL. 

MOTHERBOARD. KEYBOARD. 

POWER SUPPLY, DISC DRIVE, ALL 

ROMS. RAMS ft TTL CHIPS. SERVICE 

MANUAL ETC. £750 OR WILL SPLIT 
He PADDLES £15 
APPLE II PADDLES £5 
lie 80-COL CARD £50 
APPLE II AUTO-REPEAT KEYBOARD 

MOD £10 
MODULATOR £10 
APFLbBAG £7.b0 
DUST COVERS FROM £4.50 
DESKTOP WORK STATION WITH 4 

SWITCHED 13A SOCKETS £20 
NEW 13A PLUGS £7.95 for 20 
SILENTYPE PRINTER £30 
APPLE II MANUALS £3 EACH 
VERSAWR1TER GRAPHICS SYSTEM 

£50 

KOALA TOUCH-PAD FOR I \e £45 
ALF MUSIC SYNTHESISER £95 



USED SOFTWARE (ALL ORIGINAL) 

ADVANCED VISICALC £100 MICROSOFT CP/M AND MANUALS (NO 

VISICALC £50 CARD) £25 

DESKTOP PLAN £15 WORD HANDLFR II f?5 

FORTRAN £40 STAR TEXT (40/80 COL) £50 

WORDSTAR £90 MAGIC WINDOW (40 COL) £45 

MANY GAMES HALF PRICE - 'PHONE FOR DETAILS 



SPECIAL OFFER FLOPPY DISCS 

BULK PACKAGED INO SLEEVES OR LABELS) DOUBLE SIDED/ 
DOUBLE OFNSITY 5.25" DISKETTES. 5 YEAR GUARANTEE. 

100 OR MORE £1.00 EACH 

10-99 £1.25 EACH 

SLEEVES AVAILABLE AT 10p/DISC EXTRA 

ADD £1.80 P & P 



ALL PRICES INCLUSIVE OF VAT 
BARCLAY CARD ACCESS 

BERKSHIRE MICROS LTD - BRACKNELL (0344) 484423 
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local Group/ 

Hens & Beds Group . 
Come and join us. 

October 2nd - Macintosh Demonstration. A 
look at some of the software. 

November 6th - Which DOS? A look at ProDOS, 
Fast DOS, Diver&i-DOS, etc. why not bring 
your favourite DOS io fell us about? 

December *ih - Communications. A look at 
ASCII Express and Prestel editing in colour 
on the Apple. 

If you have any ideas tor tuture meetings or 
can contribute to those above ring Norah or 
John Arnold on&UfiiH vrm&.. 

Berks and Hants Group . 

This meets on the 2nd Monday of each month 
in FURS Building, Reading University at 
7.30. Please note the front door will be 
locked at 7A5 for security reasons. There's 
no bell! 

Meetings commence with coffee and members' 
problems, followed by a "formal lecture" 
(how formal depends on the speaker!) and 
question time, and will wind up with general 
chat time when members can seek help or 
merely chat to one another. We'll probably 
adjourn to The nearest pub around 9.30. 

we don't intend to be excessively parochial 
and stick strictly to Apple hardware and 
software - there's interesting software 
available elsewhere on other micros too. 

We brainstormed at the August meeting and 
came up with a list of possible meeting 
subjects, such ast 

Shopping basket (add-ons, etc), Assembly 
language, Low-cost spreadsheets. Which 
database?, Low-cost in-house hardware 
repairs, etc., How the bit-cop-icrs copy, 
Inter-Apple communications. How to avoid 

costly errors, Parlez-vous PascaKe)?, Other 
languages. Word processors, Graphics. There 
must be many other subjects of interest to 

us all. 

October meeting (8th) - Databases. What are 
they? Some examples. 

November meeting (12th) - Home servicing and 
repairs. Tell us about that strange fault 
and how you fixed it or ask how to fix one 



you haven't solved yet. Preventive 
maintenance, rather than fault correction. 

And so on. 

WHERE'S THE FURS BUILDING? 
Contact: Bob Mould, *tfMtittf*fe#-(4lK. 

for a map. 

. St Albans 

Other addresses: U'^r^-r^J I *«Q5 



Her ts Group meets at: 
The Old School 
1 Branch Road 
Parkstreet Village 
5t. Albans 

Essex Group 
Ut Wednesday 
"lree Top Hotel" 
Epping 



Essex Group 
Alternating 3rd Wednesdays 
Havering College of Technology 
Hornchurch 
and 
ITEC 
Harrow 

Contact: Abe Savant 111 




Old 

School^ S*r*»( 



MID-APPLE, for Birmingham and West Midlands. 
Contacts: 

bill Watson on^imi-V. ■ " 

or Mel Colder on |jj h£ ~ " 

Kent Croup is peripatetic. 

Check with Jim Panks on "< 

or with Dougal Hendry on i$ff# 'Hew**. 

Croydon Group's meeting place: 
The Shirley Poppy 
Wickham Road 
Shirley 

Check with Paul Vernon on i h : 



FORTH programmers do it on a stack. 
Visicalc users do it on spread sheets. 
COBOL programmers do it with a lot of words. 
LOGO programmers do it with turtles. 
Pascal programmers do it methodically. 



Page 26 



HARDCORE The Journal of the British Apple Systems User Uroup 



October m« 



Book Review/ 

Title: Applesoft Language 

Authors: Mack wood 5. D.o\ Blackwood G, H, 

Publisher: Howard W. Sams 

Price: LI 1.85 

Paperback, spiral bound, 9" x 6", ?7ft pp. 
First publ. 1981, 2nd edn. 19*3 

Reviewed by Brian Whalley 

The first edition of this hook was briefly 
reviewed for Hardcore in December 1981 1 but 
it is difficult to know just how the second 
edition differs from the first since there 
is no comment in cither the Preface or the 
Introduction, and no special foreword to 
this edition. The original review commented 
on the lack of Index, and this has been 
remedied. Surely this aLone isn't the reason 
for the price going up by just over 50% 
Cfrom the original 17.65) in only two 
years? 

George Blackwood claims in his introduction 
that the book is lor beginners, ior those 
who "want to learn how to program .... and 
have no opportunity for formal instruction", 
and who have "very little comprehension of 
computer programming". The chapters are 
termed "Lessons": Lesson 1 teaches the 
reader to load and save programs to tape, 
whilst Lesson 2 covers booting the disk 
operating system, loading and saving 
programs, and other DOS operations (such as 
CATALOG, RENAME, LOCK). F.ach lesson starts 
with a useful "Vocabulary" ot the terms to 
be covered, but a genuine beginner who needs 
to learn the fundamentals may be feeling 
somewhat confused even as soon as the second 
page of Lesson I, from reading the first and 
last of the twelve delinitions tor this 
opening chapter: 

"CRT This abbreviation stands lor cathode 
ray tube. The picture tube in your 
television is a CRT. The CRT can be used to 
display the output from the typcd-in input 
to your Apple computer". 

"VDM - This abbreviation stands for video 
display module, which is an electronic 
screen lor displaying data or information". 

The second definition in the Vocabulary 
section for Lesson 2 would rapidly produce 
indigestion in any but the most enthusiastic 
of novice readers: 

"DISK or DISKETTE - A magnetic disk is a 
storage device that consists of a Hat 
circular plate coated on both sides with 



some material (Mylar) that can be 
magnetized. The Apple II uses a single 
density, soft sectored, 5 l/f inch diskette 
as its virtual storage medium.The ...disk 
has a storage capacity of 118,000 bytes in 
the 3.2 disk operating system, and 146,000 
bytes in the 3.3 disk operating system. The 
DOS 3.3 will store between 100 and 120 pages 
of normal text...." 

and it continues with figures for 
tracks and sec Lor s and allocations for data 
and the directory. The Vocabulary does not 
define byte, sector or track, nor do those 
words appear in the book's index. 

The Black woods do appear to subset ibe to 
tidy screen displays, with details of HOME, 
HTAB, VTAB and TAB as early as Lesson <f. 
Lessons 5 and 6 hurry the reader along to 
descriptions and di&cussions ol variables 
and the precedence of arithmetic operators 
respectively. Lesson 8 plunges the reader 
into Relational and Logical Operators, 
whilst Lesson 9 introduces Problem Solving 
and Flowcharts - which seems a curious point 
at which to introduce a definition of 
"hardware": 

"HARDWARE - This is the name for all the 
physical units of a computer system. Hardware 
is made up of the apparatus rather than the 
programs". 

Lessons 12 and 13 cover single and double 
subscripted variables whilst Lesson U on 
String Arrays helps us to print on the 
screen various bits of the memorable 
sentence "HI SUE" before we settle down to 
the detailed flowcharting and code writing 
to solve a real problem: "to input three 
lines of variable length separated by a 
delimiter (;) to allow any length of name, 
any length of street number and address, and 
any length ot city, stale and zip code up to 
255 characters each". Is that immediately 
clear? If so, then perhaps a misprint has 
crept into this review: What, then, aTC wc 
to make of this cutious book? To be fair to 
the authors, there's a good deal of common 
sense in it, and clear explanations of some 
of the complexities of programming. To be 
lair to potential readers, however, the good 
material needs careful seeking, and there's 
a great deal to confuse and dismay the 
newcomer to programming. The semi- 
experienced microcomputer owner could be 
helped forward provided that he or she is 
blessed with patience, and the ability to 
tolerate some very curious bits of English 
that are more Blackwoodian that American, 
but this is NOT a beginner's book, unless 
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that beginner is very serious indeed and is 
deprived of access to the many better 
introductory books available to the Apple 
user. 

Title: Apple BASIC Made Easy 
Authors: Gardner D. A. A Gardner M. L. 
Publisher: Prentice-Hall 
Price: 114.35 

Paperback, 9" x 7", 2UG pp. 
Reviewed by Brian Vhalley 

This is an attractively produced book for 
the beginner in BASIC programming. David and 
Marianne Gardner arc justilied in their 
claim that the book "will teach you how to 
write BASIC programs on the Apple 11 or 
Apple 11 Plus" and that there is no need to 
know anything about computers or to have any 
mathematical Skill, l'he newcomer with an 
Apple, the Apple manuals* and the will to 
follow the book carefully, can certainly 
achieve the two goals that the authors set 
down ol learning to program well ajid having 
tun doing it. There are some good diagrams, 
and a sprinkling of cartoons which are 
likely to appeal to the excited younger 
programmer even it not so much to the 
anxious adult! 

The book starts lairly conventionally with 
an introduction to the keyboard, PRINT 
statements, and the use of NEW, RUN and 
LIST. Chapter k has a quick look it 
graphics, whilst Chapter 5 returns the 
reader briefly to hardware matters: the use 
of the disk drive or the cassette recorder. The 
topics which follow are- found in any BASIC 
programming, book: variables, FOR... NEXT 
loops, IF statements, sound effects and 
subroutines, GOTO, strings and string 
variables* and the rest- There are, however 
some interesting features. Each chapter, for 
instance, is carefully structured, starting 
with an introduction to what it covers and 
ending with a clear summary of what has been 
learned, to which is appended a set ol 
exercises. The exercises are nicely devised 
to provide interest for programmers of 
pretty well any age or background, and offer 
genuine problems without posing frustrating 
difficulties. Many of them could be of 
considerable value in any course in BASIC 
programming, whatever make of system is 
used, and are much more stimulating than 
some other so-called exercises I've seen 
perpetrated on beginners. 

Another interesting feature is a description 
of what the Gardners call "pseudocode", 
which is in effect a form of flowcharting 
but without its air ci threatening 



technicality. Examples of simple program 
outlines are presented, along with a full 
program listing and a diagram to link the 
two, for example: 

LINE NO. PSEUDOCODE 



S-30 Set the graphics screen and color 

35 For repetition = 1 to 10 
40-90 Bounce ball from left to right 

100-160 Bounce ball from right to left 

165 Next repetition 

170-190 Reset text and clear screen 

200 End 



Smaller parts of programs are expanded in 
pseudocode: 

For DOT = 39 to step -1 

Plot a green dot in position DOT.O 
Pause 

Erase the green dot at DOT.O 
Next DOT 

It's not a new idea, but it's well used by 
the Gardners, and not overdone. 

Sound effects and ln-res graphics are well 
covered without getting too elaborate. There 

is a useful chapter on PEEKS, POKES and 
CALLS - the chapter summary consists of a 

list of those specifically covered, but I 
would like to have seen that supported by a 

fuller list, perhaps as an Appendix. 

The book does in fact have five Appendices. 
The first covers disk initialisation and 
program transfer, and the newcomer to disk 
drives will find it useful in this easily 
located position. Appendix B is a 
shape-table generator which certainly works; 
it includes routines for disk and cassette 
storage and recovery of shapes, though I'm 
at a loss to understand why the routine to 
DISPLAY a shape after BLOADing or SHLOADing 
requires a back-track to Chapter 26. The 
third appendix consists of a clear 
description of the order in which the Apple 
carries out arithmetic processes, and an 
explanation of scientific notation which is 

clear if you are sufficiently motivated to 
concentrate hard. The final two appendices 
are a list of Reserved Words, and a Summary 
of Commands which could have been improved 
by including page references. There is a 
comprehensive' if slightly patchy Index. 

This is a useful addition to the books on 
Applesoft programming. Some of the sample 
programs are rather unimaginative, and some 
could work rather better, but that's true of 
some quite expensive software! 1 wouLd like 
to have seen rather more attention given to 
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good screen layouts, but that also is true 
of many professional programs. For example, 
It's reappointing and/or frustrating to 
find that the oft-used demonstration of a 
Bouncing Ball performs merely across the top 
line of the screen; to find line 120 listed 
as "FOR PAUSE = I TO 25; REM NEXT PAUSE" 

when "NEXT PAUSE" should be pari of the 
program (as in a correct partial listing six 
pages earlier); to find curious line number 
sequences such as 160, 162, 165, 170; and to 
find the program using GOSUB 900 when Line 
900 is a REM statement. 

I continue to be puzzled at the variations 
in price amongst paperback microcomputer 
books of similar size and quality of 

production: this one is surprisingly 

expensive. However, it is a book that most 
beginners of any age would find both 
instructive and interesting, and one from 
which teachers of programming could garner 
some useful approaches. 

Title: The Apple House 
Author: John blankenship 
Price: tS 3.95 
Publisher: Prentice/Hall 
Paperback : 6.5" x 9" : 153 pages 

Reviewed by Jason w. Smith 

If you ever dreamed of having your house 
controlled by your Apple, then this is the 
book to buy! It details how to use your 
Apple in conjunction with various pieces of 
hardware to control your home for you. 

It makes very interesting reading for both 
the technically-minded and the not so 
terhiiira lly-minded Apple owner, as ii opens 
up some very exciting possibilities tor you 
and your Apple. After all, imagine talking 
to your house and having it respond hy 
turning on or otl the stereo or television 
and such-like things. Wouldn't it be fun to 
be able to have lights turned on as you 
enter a room or turned off when nobody is 
around? May lie you have often thought it 
would be nice to have a phone-answering 
machine but didn't buy one because of the 
financial outlay. It could he accomplished 
using your Apple and two old tape recorders. 
What about a real-time clock, burglar alarm, 
speech -synthesis and voice recognition. John 
Blankenship covers all these topics in great 
detail throughout this book to give a 
complete and workable intelligent home- 
control system which can all be controlled 
by your trusty Apple If. 

All these facilities certainly sound very 
exciting, but there always has to be some 



minor requirement thai you must fulfil, and 
the requirement for this book is that you 
should at least have some general knowledge 
of electronics as a minimum. Many of the 
pieces of equipment needed can he purchased 
from various sources (a list ot vendors is 
given at the back of the book), but if you 
happen to like construction projects, and 
aren't too bad with a soldering iron, you 
can save money by building some sections 
yourself. Complete schematics are given for 
some of the more appropriate areas. There 
are a few bits and pieces in the book that 
cannot be purchased anywhere and if you want 
them, you will have to make them your sell. The 
author recommends a number of appropriate 
books on the subject of hobby electronics 
and the Apple ][. 

The home control system described in the 
book has five basic functions. These are- 
Voice request, Phone control, Security 
management, Event timing and the monitoring 
of movement ihroughout the house. The VOICE 
REQUEST module allows communication with the 
computer using a wireless microphone. With 
this module you can control the lighting, 
ask what time it is, turn on the security 
system, turn appliances on and off and much 
more. The PHONE CON I ROL module will turn the 
Apple into an intelligent answering nidchine. It 
also allows you to contact the computer from 
a distant location by phone and request 
information on the status of your house when 
you're nm there or instruct the computer to 
perform some operation such as turning 
lights on or off. The module for SECURITY 
MANAGEMENT monitors doors and windows and. 
because the system is intelligent, you could 
have it pliune a neighbour if it detected an 
intruder. EVENT TIMING provides a means of 
establishing a list of events that need to 
occur on an ongoing basis. For example, the 
computer might wake you at seven o'clock on 
weekdays but let you sleep until ten at 
weekends. The heating should be turned down 
or oft when no-one is home and then back on 
just before someone arrives home. This 
information is held m tables which can be 
edited depending on how your lifestyle 
changes. The INTERNAL MOV EM EM module 
watches various sensors to keep track of 
where people are in the house. This 
inioimalion is used to decide what lights 
should be turned on or off as people enter 
or leave rooms. Juhn Blankenship states that 
ii is possible to use these modules alone, 
all together or with the addition of some of 
your own. This is due to the flexibility of 
the software provided, which is written m 
Applesott. 

The book is divided into four ports. Part I 
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is an introduction and on overview of the 
entire system. Pari II describes all the 
hardware that will be required to make the 
system operational. Pieces of hardware that 
cannot be purchased are examined in greater 
detail than off-the-shelf items. Part 111 
pertains to the actual program coding used 
to implement each program module. I must .say 
that the main BASIC program is well 
structured and easy to follow, but I do not 
like the idea of program lines ascending in 
increments of one, two and sometimes five as 
this could be rather tiresome ro type in. 
Luckily you can purchase an un-protected 
disk with all the software in the book for 
$12.50. Part IV shows you how to put the 
hardwire and software together to create 
your Apple-controlled house. 

In summation 1 must say that 1 did find the 
book clearly written with no obvious errors 
in the text or in the programs supplied. This 
book has inspired me towards the idea of 
having the Apple controlling various things 
in my home. It is not a very large book at 
only 1 >3 pages, but it certainly contains a 
great deal of information oft turning your 
house into "the first Apple house on the 
block". 

Title: Using the UCSD p-System 
Authors: K.Buckner, M. J. Cookson, 
A. L Hinxman, A. Tate. 
Publisher: Addison-Wesley Publishing Co. 
Price; 1 11.95 

Reviewed by Adam Broun. 

This is a book aimed at "guiding the 
complete beginner through aspects o£ the 
(UCSD) system necessary for it to be used 
safely and sensibly". It deals with the UCSD 
system as a whole, examining the filer, 
editor, and other parts of the system, 
without being too specific about either 
language or machine. Of course, when one 
sees UCSD written somewhere, mentions of 
Pascal are never far behind, and the second 
part of the book relates to Pascal, insofar 
as It applies to the UCSD system. 

My biggest worry about the book, which 
stayed with me the whole time I was reading 
it, was that I could never be sure at whom 
it was aimed. The iirst chapter is entitled 
"Basic concepts of computing" and goes on to 
provide a fairly standard, if rather 
convoluted introduction to the concepts of 
information storage, memory, etc., including 
explanations of how to put disks into 
drives. Subsequent chapters go on to using 
the system in great detail, and throw jargon 
about like it was going out of style. For 



example, in chapter t, which our computer 
novice has been told to turn to in order to 
adapt the system to his computer, he is 
casually told oi "A miscellaneous 
information file (SYSTEM.MISCINFO) 
containing the terminal character sequences 
needed to perform various output operations 
... and the character sequences to be 
interpreted on input as requesting some 
operation". 

The book continues by giving thorough, it at 
times confusing, expositions of the rest of 
the system, and includes a few real pearls 
of wisdom, such as hints on how to undelete 
files. However most of the information 
covered is also in the standard Pascal 
manuals, and usually the manuals are a good 
deal easier to read, especially since they 
are Apple-specific. The book attempts to 
cover USCD implementations for several 
machines. 

To sum up: the book tries to do something 
very difficult, and probably fails - that 
is, to get a complete novice to computing to 
start off on the UCSD p-systern. It may, 
however, be useful to the more expersenccd 
user in providing a condensed summary of the 
system. 

Finally, a warning lu those who still have 
the old version 2.1 system: Many of the 
features described in the book arc not 
available on the older systems, and a brief 
summary of these is given in an appendix. 

Keyboard 
lowerca/e mod. 

Apple 11+ keyboard - Lowercase modification, 
by Dick Mcnhirwck. 

Some months ago, I reviewed a book catted 
'The Apple II Circuit Description' by 
Winston Gayler in Hardcore. bi this review 
I mentioned a section in the book which 
described how Apple had allowed for upper 
and lowercase operation in the Rev 7 (two 
part) keyboard encoder but had tailed to 
tell anyone about it! 

Since then, a number of BASUC members have 
approached me and asked for details on how 
the Apple It* keyboard can be modified to 
make use of this feature so I decided to 
modify my own keyboard and write the process 
up for Hardcore. 

The KR3600 chip which Apple use in the 
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keyboard encoder has 9 outputs, of which 
only 7 are used. Bits 5 and 6 arc normally 
the two most Significant bits of the 
keyboards output ASCII code. However, this 
chip has been preprogrammed with two sets of 
codes, and if bits 8 and 9 are substituted 
for bits 5 and 6 respectively, the other key 
code set may be accessed. 

If you remove and examine your keyboard 
encoder board and compare it to 
figure I, you should be able to identify 
the two 'bow-ties' or 'butterfly-pads' 
adjacent to the RESET/CTRL-RESET slide 
switch. These sit above and below six holes 
which arc laid out to accept another slide 
switch of ihe same type as the RESET switch. 

Examination of the circuit board, shows thai 
the two 'butterfly-pads' connect the data 
bits > and 6 with the outputs 5 and 6 on the 
encoder chip. However, if the other iwo 
contacts (the ones not connected to the 
■butterfly-pads') are examined, you will see 
ihat these are connected with the encoder 
chip outputs X and 9. 

Now, if you carefully cut the copper track 
between the two 'arrow-heads' of both 
butterfly pads and fit a suitable 
double-pole double-throw (d.p.d.t) switch 
you will have the facility to switch between 
the standard Apple 'uppercase-only' 
keyboard, and a lull upper and lowercase 
keyboard where the 'shift' keys work 
correctly! figure 7 . 

I fitted my switch off the board using long 
connecting wires, so that I could mount it 
through the metal baseplate of my Apple just 
under the keyboard. This removed the 
necessity to open the lid every time 1 
needed to change the position oi the switch. 

Softw are-Support. OI course, as soon as 
I had modified my keyboard I wanted to try 
it, so, after carefully reassembling the 
machine 1 switched on, loaded DOS and tried 
to type some BASIC lines in lowercase. It 
didn't work! 

"Rats! I must have the switch in the wrong 
position" I thought. I switched to the other 
position. I tried a couple of PRINT 
statements - it didn't work! 

Apple!!!" I cxpleted! 

One of my greatest strengths is my 
unswerving ability to recognise when I am 
beaten. So I gave up and did something else. 



A few days later, I decided to have a look 
at the latest messages on the Bulletin 
Board. Out came my trusty 'ASCII Express' 
disk and 1 booted up, dialed 07'* 2 667983 {as 

it was) and waited ! Up came 

the header and the greeting, and the 
acknowledgements, and the waffle and ... and 
... and ... at last came the invitation to 
log in. 1 typed in my name. 

IT WAS IN LOWERCASE ON THE SCREEN! 



The dreadful thought 
fterk!" I mused. 



then struck "You 



In case you are now wondering what the hell 
I am going on about, 1 should point out that 
the good-old-trusty Apple Monitor keyboard 
input routine converts all lowercase 
keyboard codes into uppercase! Of course 
this routine is ubed by Applesoft which 
explained my earlier frustration. 

The solution seemed loo easy! So you will 
find, that unless you arc using a 
case-sehsitive screen editor like P.L.E you 
cannot put lowercase prompts into your 
programs! However, if you have a GET 
statement or are PEEKing the keyboard 
register you will get the lowercase you 
richly deserve. 

The following programs will accept lowercase 
from the keyboard. This list only mentions 
the programs that I have personally tried - 
there are undoubtably many more. 

Mousepaint, ASCII Express, P.L.E., C.P.L.E., 
Magicalc (The Spreadsheet), Micro-Painter, 
P.P.S.file, P.F.S.reports. 

The two illustrations were drawn using 
'Mousepaint' on an Apple II*. 



yCut butterfly pads 
at both positions 
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LETTERS AND EARLY READING, 
by G.G.Wood. 

The recent challenge by Norah Arnold cost me 
many lale evenings. Her request tor 
children's programs encouraged me to 
complete a program for letter awareness and 
early spelling. 

I started nine months ago with the big 
Letters program by Ian Trackman which came 
gn my Basug introductory Disk. It was easy 
to add a patch so that any key pressing was 
echoed on the screen as a large letter. My 
three year old daughter was very happy 
pressing keys and recognising the letters: 
"M lor mummy, D tor daddy", she would shriek 
after tinding them on the keyboard. The 
initials oi her name all gave great 
excitement and real learning. She rapidly 
became fluent in all the letters, and spent 
many happy sessions on my knee gaining 
confidence and reinforcement ot her Alphabet 
Books. She still loves to type random letter 
groups and ask me to say them. 

"BUT", said my wife, "what about lower case 
letters?'"- "What indeed", I answered, as 
ian's progidin is only upper case... Well, 
the lirst modification had been easy and Ian 
used a good modular layout with plenty of 
comment, so fond parent decided to further 
child's education. 

First figure out the method of encoding 
letters (it's not x,y as a mathematician 
would assume), then develop a keyboard 
routine which emulates the case switching 
method ot apple writer, then realise I need 
descenders, so extend the letter array irom 
5*7 to 5*8, then selective erase to stop 
descenders interfering with the line below. Ian 
really knew what he was doing to implement 
only upper case!! 

This took many long evenings and somewhere 
on the way 1 got fed up with the 30 second 
wait while the program loaded its arrays 
every time it was RUN. This turned into a 
real challenge, I finally solved it using 
the keyboaid value as a pointer in -the 
cxpression:- 

ON key GOSIIB n,ii,n,n, 



with 'f5 different n's switching to rouiinps 
for *»5 of the letters. 

The next evolution was to type words In 
upper and lower case linked into the 
original program feature for storing, 
editing and displaying complete messages (up 
to lines). This allowed me to build 

stories based on words from the child's 
eai ly reader. All the adventures of Dick and 
Dora are now part of her "big letters" 
program. «My daughter loves reading them and 
the extra attention from other family 
members as she reads the words. 

I can highly recommend this program to help 
pre-schoolers develop letter awareness and 
reinforce their early reading skills. Perhaps 
Basug will put it on the introduction disk 
or a childrcns collection. I pass on the 
next challenge for another fond parent to 
add a simple picture function to enhance the 
stories. 



Subject: Magic Spells 

Publisher: The Learning Company 

4370 Alpine Road 

Portola Valley 

CA 9002 5. USA 
Prirei 122.95 ♦ VAT 

Available from P & P .Micro Distributors Utri. « 

Reviewed by Elizabeth R a ikes 

This game is for 6 to 10 year olds. It tries 
to teach you to spell by unscrambling 
anagrams. It you get it right you win the 
gold. If yuu get it wrong the wizard of 
spells gives it to the demon. If you get all 
the spells right you win the treasure at the 
end of the rainbow. You can try the wizard's 
spells or make up your own lists of words. 

Magic Spells 1* a fun game especially for me 
because I like it if the demon doesn't get 
any gold. I think it is good for children 
younger than six if you write lists of words 
which arc very simple. Parents usually have 

to write the lists to make sure they arc 
spelt correctly in the first place. 1 think 

it's worth playin K and 1 play it quite a 

lot. 
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fidmin. 

THE ADMINISTRATOR MOVES HOUSE. 

By now many oi you will have experienced the 
tortuous loule you have 10 travel via the 
telephone network in order to talk to me, or 
a slight delay in the procccssing ol your 
orders. It is quite probable that you have 
also become very bad tempered in the process 

don't blame you) and wondered what the 

hell it was all about! well, if you are 
sitting comfortably, let us begin. 

Last year my fiance and myself decided to 
sell our respective houses and purchase one 
together. My house in St Albans went first 
and soBASUC moved to Bracknell. A few weeks 
ago we found ourselves in the unenviable 
position of having also sold the Bracknell 
house before completion on our new property. 
Oh, what panic >ci in. Not only did the 
furniture have to go into store, the dogs 
into kennels and a temporary home be found 
for us but what whs going lo happen to the 
BASUG office temporarily? After many hours 
of biow beating and tearing out of hair wc 
found the solution, ftob Mould (a gallant 
member of the club) allowed us to have our 
telephone no. re-directed to his own line, 
enabling us to use an answering machine to 



take messages; also the post was re-direr ted 
to his address. This meant that I could call 
in once a day, pick up the post and messages 
and deal with it in my liance's office (who 
was very tolerant of the situation). But in 
the process of dismantling my office, 
setting it up temporarily and once again 
moving il into the new house I am afraid 
there have been short delays in answering 
the post for which I apologise. 

As 1 write this I am waiting for the phone 
to ring to confirm that contracts have been 
exchanged on our new house and ihai 
completion will be on Hth September, then 1 
shall jump on the Post Office and British 
Telecom and plead with them to change all 
the re-direction orders from Bob Mould's 
house to our own and with a bit of luck 
BASUG will be finally and permanently in 
business In a settled address with no more 
confusion. My new telephone no. is 0635 
<*6385. Please cross out of your little black 
books ALL previous telephone has., etc. 

One final note, our packers were so highly 
efficient at swooping everything into their 
arms and into boxes that, in a couple of 
weeks time, I shall have to unpack 4 cooked 
sausages still in the* frying pan that we 
were going to have for our lunch a few weeks 
ago! Oh, the joys of moving!! 



AF= FI_E GAMES EXCHANGE 
ARE VOU 
90RED with the same Old Gafnes 
DO YCltJ 
riND the New Ones are OVERPRICED 
NOW 

YOU can exchange your ULL> Arcade and 
Adventure Games from ao little as £3.50 
Send S.A.E. for full details together 
with a list nf thp games you wish to 
exchange to: - 

APPLE GAMES EXCHANGE 
P.O. BOX 21 
DISS NORFOLK IP22 3DQ 
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BASIC note Education 



Here is a short BASIC program which you may 
find interesting. Try typing it in and see 
what it does. H you write games you may 
find it valuable to study this technique. 
Thank you to Adam Broun who sent it in. 

REM WRITTEN BY A.M. BROUN 
10 HCOLOR- 7 

20 GOTO 1000 

30 HS = PEEK (230) 

10 If HS = yi THEN 130 

50 POKE - I ft 799,0 
60 HS - 32 
70 GOSUB 230 

80 POKE 60,0: POKE 61 ,64: POKE 62, 
255: POKE 63,95: POKE 66,255: POKE 
67,31 

90 CALL -*6* 

100 HCOLOR = 0: HP LOT 0,0 TO 279,0: 
HPLOT 0,6ft TO 30,6ft: HCOLOR = 3 

1 10 POKE 2ft575,0 
120 GOTO 210 

130 POKE -16300,0 

IftO HCOLOR- 0: HPLOT 0,0 TO 279,0: 

HPLOT 0,6ft TO 30,6ft: HCOLOR= 3 
150 HS * 6ft 
160 GOSUB 230 

170 POKE 60,0: POKF.61,32: POKE 62, 
255: POKE 63,63: POKE 66,255: POKE 
67,63 

180 CALL - ft68 

190 HCOLOR = 0: HPLOT 0,0 TO 279,0: 

HCOLOR = 7 
200 POKE 16383,0 
210 POKE 230, HS 
??0 RETURN 

2 30 CALL - 182 
2ft POKE 7 1,0 
250 CALL - 193 
26 RETURN 
1000 Y = 80 

10 10 HGR2 : POKE - 16 302,0 
1020 FOR 1 - TO 279 

1 30 Y = Y *- RND (I) * 6 - 3: HPLOT 

1,191 TO I r Y 
lOftO NEXT 
10 50 GOSUB 30 
1060 FOR 1 = 272 TO 2/9 
1070 IF Y t RND ( 1 ) * 6 - 3 > 279 

OR Y * RND ( I ) * 6 - 3 < THEN Y 

= Y t 10 

1080 Y = Y * RND (0) -6-3: HPLOT 
1,191 TO l,Y: HCOLOR t 0' HPLOT 1,0 
TO I,Y - I: HCOLOR= 3 

10 90 NEXT 

I 1 00 GOTO 1050 



by Norah Arnold 
A Review 

PROGRAM: CLASS MARKS 
AUTHOR: ANTHONY GAME 
PRICE: t?0.00 
CONTACT! Tel. 039ft 282820 

Every teacher, regardless oi which age group 
they teach, spends a great deal of time 
writing out and manipulating lists of names 
and marks. The author ol this program, being 
a retired teacher himself, has tried to 
produce something which will cut down the 
time spent over mark lists. 

When the disk is first booted a title page 
is displayed and you are requested to press 
any key. This brings up thp main menu which 
can be recalled at any time by pressing 
Control X. The first item on the main menu, 
Begin new list, can be accessed by pressing 
B. You are then asked to give the list a 
name and state how many pupils will be 
entered. Next you are prompted to enter the 
names and the marks. 1 found this section 
quick and easy to get through once I was 
used to obeying the conventions listed in 
the instructions, i.e. surname to be entered 
first, followed by one Christian name or an 
initial. 

Although you are given an opportunity to 
check your typing immediately after entering 
the list, 1 found the next option on the 
menu -R Read list, handy tor checking what 1 
had actually got in the list. Other options 
on the menu alio* you to add names to the 
list or delete names from the list. One can 
also change a mark on the list if it is 
found to have been entered wrongly. 

The next item on the main menu is -X Change 
all marks. This item can save you a great 
deal of time if yoo work with the same 
pupils over several months. Having typed the 
names in once for one set of marks relating 
to one subject, the list can be recalled, 
renamed, and the marks for the new subject 
entered. Next come two items on the menu 
which help with sorting the marks and names. 
Pressing P puts the list of marks into 
numerical order and calculates positions, 
and it does it with reasonable speed. Pressing 



WILDCARD PLUS 

COPIES 64K PROGRAMS IN 12 SECONDS 



The new WILDCARD PLUS is the card that thinks for itself. One push of the 
button, one simple menu - with its own 6502 processor WILDCARD PLUS 
makes a perfect copy on any Apple, from a 48K ][ to an extended 128K // e. 
Automatically. Does for copy protection what Atilla the Hun did for social 
reform . 




□Hardware copying 
device , push button 
operation. 
□Copies 48K programs 
in 8 seconds, 128K 
programs in less than 
25. 

□Creates autobooting. 

unprotected disks. 
□Software in ROM. 
always th9ro...no 
t»eed to preboot. 
□No language card 
required, works 
equally well with or 
without. 
□Utilities include: 
compression software- 
several backups may 
be stored on a single 
disk, recover BASIC 
programs, disassemble 
machine code soft- 
ware, screen dumps, 
etc. 



WILDCARD PLUS 
£119 

From your local dealer, 
or direct from: 

Elite Software Company 

93 Eastworth Road 
Chertsey, Surrey 
KT16 8DX 

Tel: 09328 67839 

Add 15% VAT for 
delivery in UK P & P 
included. 



Dealer enquiries 
welcome. 



Apple H a rested trKtema* Q ( Appfc Computers inc 



Page 36 



HARDCORE - The Journal ot the British Apple Systems User Group 



October 19S4 



O puis the names into alphabetical order. Both 
these options, to calculate positions and lo 
put in alphabetical order, Rive you the 
chance to reverse Surnames and Christian 
names &o that you could print Fred Rloggs, 
Bloggs Fred or even Bloggs F if you had 
entered an initial only. A point to wa.tch is 
that the names must be Surname first when 
the list is saved to disk but this is 
explained m the instructions. 

Next come two options which are very useful 
indeed. Main menu option M allows you to 
standardise marks by setting another mean 
and standard deviation, so enabling you to 
compare marks from different sources. Option 
T will let you present your marks as 
percentages. When using this option I found 
it best to save my original list to disk, 
recall it and change the name, then convert 
the marks to percentages, so that 1 still 
had tlm original marks if I needed them. 

The disk menu gives the normal choices of 
catalog, saving a list or reading a list 
from disk. It also gives you the chance to 
save to a Totals list. This rivcs you the 
choice of keeping a marks list as a single 
set of marks, or of adding them to another 
list, railed a Totals list, which adds the 
new marks to the previous ones and stores 
them as a total or an average- This may be 
done as often as necessary so that a whole 
term's totals or averages could be stored. 

There are many good points about this 
program, not the least being the speed at 
which one can obtain a list of marks and 
names in order of position, always a tedious 
job if the list is long. The program is 
fairly easy to use at the beginning and very 
easy once you are familiar with it. One 
little useful point is that a list of names 
may be printed without the marks if 
necessary, giving a speedy way to produce a 
Hist for checking off which pupils have paid 
their outing money, for instance. I have 
always used Visi-Calc for keeping records of 
marks until now, but although Visi-Calc has 
a few advantages to that one can choose how 
many columns of marks or which part of a 
list to print, it is slow and tedious after 
using Class Marks. I shall still have to use 
Visi-Calc for some things, especially where 
a Special look-up table is needed to 
interpret the marks, but lor the everyday 
mark list I shall use Class Marks. 

There are one or two little things that 
might be unproved. It is very nice to have 



the choice of upper or lower case for ihe 
names, but 1 met a difficulty with the lower 
rase. I tried to put in the name O'Donnell 
and couldn't, neither could 1 put in 
McKivett. The apostrophe could not be 
entered in O'Donnell, and in both the names 
the second capital could not be entered 
correctly. 1 got round this by doing that 
list in upper case and leaving out the 
apostrophe in O'Donnell. Also it would be 
pleasant to have the choice of single or 
double spacing the lines of a printed list. These 
are small criticisms which 1 am sure the 
author will consider putting right, 
otherwise Class Marks is a very useful 
program for a teacher to have around. 

EXAMPLE US I 



NAME 


MARK 


PUS 


Stephens Joan 


8* 


1 = 


Inestvne Patrick 


89 


1- 


Brigqs .Inhn 


82 


3 


Turner Catherine 


7V 


4 


Johnston Brian 


70 


5 


Miller Carol 


65 


6 


Lawson Peter 


hJ. 


7 


Hendrick Anne 


57 





Dyson Miles 


S3 


9 


Drendrick Audrey 


52 


10 


l.flurpnre Stepl leu 


48 


1 1- 


Drench Joan 


4S 


1 1 = 


Wright Joan 


46 


13 


Marks AnnPtte 


45 


14 


Arnold James 


44 


15 


Rjclnsrd^on Janet 


41 


16= 


Jolly CharlPt; 


41 


16- 


Hawes Stanley 


38 


18 


Bain Tertiiiue 


3-6 


19 


Catterltl-. Joan 


53 


70 


rranke Gi 1 1 i on 


30 


21 


Mi tnhel 1 Wi 1 1 lam 


29 


zz 


Birche John 


28 


'? 


Arkwriqht Richard 


25 


24 


Arkrnyd Kenneth 


24 


25 



Seedling/ 



Macintosh 512k Big Mac is promised by Apple 
(or October 1st. It will cost LSOO ior an 
upgrade. This must mean that Louis 1-2-3 is 
on the way. 

Softalk have iiled for bankruptcy. 
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Programming Utility 
by Rugei Hairis 

There are many sophisticated Apple utility 
programs which help to develop a new program 
or service an existing one; line editors, 
programs which renumber lines or find 
variable names or strings are examples. The 
following BASIC program, called Lister 
because it started out as a means of listing 
selected program lines with output to screen 
or printer, helps mc to perform ccriain 
frequently used operations by using a RUN 
command tollowed by a one or two digit line 
number, e.g. RUN 1 instead of LIST 
2 500,2599. The line numbers, and their 
labelled keys, were chosen to minimise 
finger movement and to avoid clashing with 
key labels I've placed on keys 7, x and 9 
which form part of a "numerical keypad" (sec 
Windfall, April 198*, p. 22 for details and 
hex dump). 

Lister occupies lines 1-12 and 60000-60200. 
Line leads to the start ol the program 
being developed or serviced which fits 
between lines 12 and 60000 and is thus 
embedded in Lister which may be deleted once 
work is romplete. (Is it ever?!). A new 
program may simply be typed into Lister. An 
existing program may be merged with Lister 
by using a Merge Utility such as •Renumber' 
(available on DOb 3.3 System Master disk) or 
APA (available on DOS TooL Kit disk). 

The commands arc as tollows: 

RUN l: Lists on the screen a selected 
program segment. Sec 'RUN 11'. 

RUN 2: Prints a program segment with a 
page hcadinR showing the program name, date 
and time. The command asks lor a REM to 
describe the segment and lor a reprint/ 
ieiial number (cosier than retyping line 
60150). 

RUN 3; Type <RETURN> to set screen width 
to 33 columns. Type <3> to return to TEXT 
mode (*0 columns). 

KUN U: Same asCALL-151 to enter MONITOR. 

RUN 5i Same as CATALOG. Command asks for 
drive number, i.e. I ot 2. 

RUN 6: SAVEs Lister and its embedded 
program to drive 1 or 2 using the name, date 
and time shown in lines 60100-60120, e.g. 
PROGRAMNA.ViE.3IAUG8 i *.1635.ListPr does not 



check il the name length is more than the 
maximum of 30 characters. 

RUN Hi Lists on the screen the lines 
showing the program name, date, time and 
also the line numbers of a program segment. 
The lines may be amended by re-typing using 
ESC 13KM to move the cursor. 

RUN 12: Resets "last drive used 1 to 
drive 1 or 2. 

Since using Lister whilst programming each 
subroutine and segment now has its own page 
in a loose-leaf binder with its program 
name, REM, date and reprint number together 
with other descriptive data and notes. Updated 
versions of programs, when SAVEd to disk, 
now liave a consistent filename showing date 
and time to indicate "freshness". 

GOTO < LINENUMBER > : REM SEE 

TEXT 

1 GOSUB 60150: END : REM LIST 

SEGMENT 

2 GOTO 60000: REM PRINTER 

3 GOTO 60050: REM PAGE WIDTH 

4 GOTO 60G&0: REM MONT TOR 

5 GOTO 6007 0: REM CATALOG 

6 GOTO 600&0: REM SAVE PROGRAM 

11 GOTO 60090: REM LIST DETAILS 

12 GOTO 6U1UU1 REM SELECT DRIVE 

59999 END 

60000 INPUT "REM ";H$: PRINT : 
INPUT "REP *";S$: GOSUB 60110 

60010 PRINT CHRS < 4 ) ; "PRil" ; 

CHK$ (13): POKE 1657,80 
60020 PRINT "PROGRAM-" ;P$; SPC ( 9); 

"DATE=";r>S;TS; SPC< 9); 

n REPKINT= M ;S$: PRINT "REM-";R$ 
60030 GOSUD 60150 

60040 PRINT CHRS (4);"PR#0": END 
60050 GET QS:D - VAL (Q$); 

POKE 33,33 l 7 * (D = 3) : END 
60060 CALL - 151 

60070 INPUT " CATALOG DRIVE *";D: 

PRINT CHRS (4>;"CATALOG,D"; 

(D= 1) + 2 * <D= 2): END 
60080 GOSUB 60110: INVERSE : PRINT 

PS;D$;T$: NORMAL : INPUT "SAVE TO 

DRIVE t";D: PRINT CHRS <4); 

M SAVE";P$;D$;T$;' , ,D H ; 

(D= 1) + 2 * (D « 2): END 
60090 LIST 60110,60130: LIST 60150: 

END 

60100 TNPUT "SELF.CT DRIVE #";D: 
POKE 43624,(1 + (D " 2)): END 
6O110 P5 _ "LISTER " 
60120 DS = ".01SEP84" 
60130 T$ ■ ".2200" 
60140 RETURN 
60150 LIST 00000,63000 
6O160 RETURN 
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DS 3 

Reviewed by Bob Kaikes. 

Regular readers of Hardcore will have seen 
mention in the past of the group 
'Mainframe', in particular an interview in 
the Ocober '&3 Hardcore. In that interview, 
mention was made ol a 'drum machine' on the 
Apple being used on a record. The D.S3 is the 
commercial product that has developed from 
this board. TV viewers may have seen the 
hoard on '.Me and my vlicro' or 'Tomorrow'* 
world'. 

The DS3- consists ol a board that fits into 
the Apple (Slot 5) and a cable which comes 
out of the Apple to a connection box to 
attach to your sound system. The full system 
includes a five octave full size musical 
keyboard, also on a cable from the Apple. There 
arc 3 disks of software. To use the DS3, you 
need a **8K Apple with disk drives and 
paddles. The Apple can be of the I or //e 
variety, if a t, then a I6K Language/RAM 
card is an asset. It will not work with an 
ITT2020. 

The system works on the principle of digital 
recording or 'sound sampling'. In this 
pi ones* the last changing voltage levels 
from a microphone, generated by an audio 
signal are converted into numbers. These 
number* ran be processed and stored and then 
converted back to an audio signal by a 
reverse process. The faster this is done, 
the more accurate the final Signal is. A 
scientist called Nyquist established that to 
accurately reproduce any signal, it is 
necessary to sample it at twice the 
frequency of the highest signal to be 
rerordpri. In the case of sound up to the 
limit of most people's hearing at about 
l^Kliz. this means sampling at 30Kllr.. The DS3 
meets this criterion hy sampling i\\ that 
speed. 

The recorded sound can be stored away on 
disk, and recalled at any time for 
translation into sound. One of the main 
problems involved in this system is the 
amount of memory used. Tor each second of 
sound, 30K of memory is used. This limits 
the maximum length of a sound recorded on 
the DS3 to between 1.5 and 2 seconds. If all 
you wished to do was record and replay a 
fixed sound, then this ability to record 
would be of limited value only. This is the 
reason that it was originally seen as a drum 
machine. Most drum kit sounds die away 
fairly rapidly so that it was possible to 



fit in the Apple's memory three or tour 
different drum sounds at the same time. A 
program to string them together was written 
and so a drum machine was made. Aspiring 
drummers (or their neighbours) will 
appreciate the advantage of a means of 
producing the sound ol a drum kit 
electronically. The machine was first 
demonstrated to the BASUO Herts Local Croup 

in more or less this form. Very impressive 

it was too. 

However, having converted a sound into 
numbers, it is relatively simple to process 
the sound by editing it, or by changing its 
frequency. If you can change the frequency, 
you can reproduce the note at a different 
musical pitch, so the next step was to 
develop a keyboard interface to play the 
notes back. This was done, and software was 
written to make full use of it. What this 
means is that you can record ANY sound 
and play it back ... in four part harmony!!! 
The musical possibilities are limited only 
by your imagination. 

Anyway, let's look at the facilities 
provided. From the main menu, the first 
option is 'SOund Sample'. This is. the part 
of the program that records the sound. Hirst 
a microphone has to be connected, via some 
kind of pro-amplifier (hi-fi amp, cassette 
deck, etc.) to the input socket of the DS3. This 
only accepts line level signals. The sound 
sampler, orice activated, works by detecting 
any sound above a threshold level. This 
threshold can be set by the usee Alternatively 
the sampling can be started and stopped 
manually, when the sampler is not activated, 
the wavefui in of «iny sound being fed into the 
system is displayed on the high res screen 
as if on an oscilloscope. This allows the 
adjustment of sound levels to minimise 
distortion. Once the sample is complete, you 
can go into play mode and the sound can be 
played back from the Apple or musical 
keyboard. This is great fun, especially with 
children speaking oi singing into the 

microphone. The final option in the sample 
section is 'trim'. This routine allows the 
beginning and endr. of the sound to be 
trimmed both to save memory, and to avoid 
any time lags in the keyboard responding. To 
make trimming easy, the waveform is again 
shown on the high res screen. 

The next facility from the main menu is 
waveform editing. As with the sample 
trimming, this shows a sample on the high 
res screen. This section allows the waveform 
to be changed to eliminate clicks at the 
start or end of the note, or to change the 



GREENGATE 

product ions 



When you buy a Greenyate DS;3 
you are entsfinQ a nftw world. Not 
only are you providing yourselt 
with o high quality 4 voice Sound 
SampEer to match the best around 
for all-in performance bin you are 
into a new kind of sequencing 
which is ONLY possible with a full- 
blown computer system. 
The Sampler speaks for itself ... 
But what Drum Machine or 
sequencer unit can: 

□ Give you INSTANT access to 
8 individual 4-note polyphonic 
sequences while playing live? 

□ Give you INSTANT drop-ins 
(Or drop-c«utsl) 

□ Provide single or multi- 
sequence triggering? 

□ Allow synch to or from external 
source at all times? 

□ Provide you with COMHLblb 
records of your sonq 
sequences on floppy disc in 
digital, non-degradeable form? 

□ Remember the instrumenta- 
tion details as well as the 
sequences? 

□ Lot you substitute ANY 
instrument ANYWHERE in 

your sequence at any tfme- 

Itve or step. ..? 
We don't know of one. But we DO 
know that the DS:3 is one of the 
very best drum sequencers. We 
have a collectois item 12" record 
to prove it . . .YYY001 . 
Ask around tor a copy ... or send 
us a PO for two pounds and it's on 
its way! 

Sampling AND Sequencing? For 
£250? 

The Greengate DS:3 does JUST 
THAT... 
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GREENGATF PRODUCTIONS 
Sound Samplmg S«qwtf>«f, tht 

nf ovary muUrian and tfudifi 
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Muftd Qu.lrtv Pftwartul MOo-nciMJ *otfw».» IOfl«th»r with S.octav* 
kovbwd DQntral o( otch S ™ o M^uMJoA/drnm U cpobXr, lim ,<,d only 
ov tM mtfi imwlmiton. Thorn art no "PROMS' CfWW or dxim 10 Buy! 
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GREENGATE PRODUCTIONS, 24 MISSDEN DRIVE. HfcMEL HEMPSTEAD, HERTS. HP3 8QR. Tel: 0442 3496 
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shape oi a sample. Unfortunately, this can 
be a very slow process as each value has to 
he individually set. This section would look 
to me like a natural application tor a Mouse 
to allow fast editing and perhaps ueation 
of completely new waveforms. 

The lliiid option on the main menu is ihp 
Sound Hiay/Sequence option. This brings you 
to the other major part of the system. First 
you must select the sound(s) that are going 
to be used and the tempo. Ihis part ol the 
program allows you to 'record' the sequence 
of notes played against a metronome beat. The 
recorded sequence can then be played back or 

set to repeat. For example it is quite 
simple to record a 2-bar drum sequence and 
then set it to repeat. The resulting steady 
rhythm is very useful when practicing or 
'composing' music. I he sequencer has tour 
different channels* so that four different 
sounds can be played simultaneously. For 
example^ when recording a drum scqucncci it 
is best to sound each type of drum or cymbal 
on a different channel so that each sounds 
for its full time. 

Each sequence on each channel can be saved 
and allocated to a different key on the 
Apple keyboard. The sequences can then he 
merged so that they are played 
simultaneously and the merged group can be 
assigned to a new key. Up to nine different 
sequences can be available from the keyboard 
at any one time. Sequences can be appended 
to each other to form new longer sequences. 
Each of the sequences is saved to disk 



{ song file <■ 

PERFORMANCE < song file 

( song file 



separately. There is a further 'chain' mode 
that will rerorrl the order in which 
sequences are played and allow this 
information to be saved and again allocated 
to a key or saved to disk. 

A 'set-up' file can be saved, and this will 
detail the sounds used, the sequences and 
chains used and the tempo etc. A 'set-up' 
file can be converted into a 'song file", 
and these can be combined into a 
'performance file*. By this point, you may 
be as confused as I was when I first tried 
to get to grips with the different types of 
files, and a diagram may be helpful. 

The top of this tree tile structure is the 
performance file. If this is used for live 
music production, it will play each song in 
sequence, automatically loading the new 
sounds, parameter s . and sequences, wailing 
for one key press between each song. The 
main limitation to this is disk capacity. 
Although sequences and other data do not 
take up a great deal of room, the sound 
samples do. This means that if you are 
creating performance set ups with many 
ditterent sounds, you will very quickly fill 
disks. Song and Performance files are 
created using separate options from the main 
menu. 
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There is an option labelled 'Sequence 
Develop' on the main menu. This seems to be 
the beginning of a fairly powerful sequence 
editor. At the moment, you can merge, chain 
and list sequences to the screen or printer You 
can also add or delete spaces between 
events. It is not possible to change or 
delete an event, nor enter sequences from 
the editor. 

The final area available is the facility to 
change the allocation of notes on the Apple 
keyboard. This is important when using the 
non-keyboard version of the DS3. as the 
Apple keyboard can be used like a musical 
keyboard. New set-ups can be saved as files. 

I-n use, the system is the first system I 
have seen, other than the Alpha Syntauri, 
that is usable for practical music making. It 
docs all that it claims. The quality of 
reproduced sound is very good,, but, and it 
is an important but, like any recording 
system, the sample is only as good as the 
skill of the person who recorded it. A good 
quality microphone, and some idea of 
microphone technique are both needed to 
achieve the highest quality results. Access 
is also needed to instruments as required. Good 
basic drum sounds and some instruments come 
with the system, and 1 understand that 
further disks of sounds are available from 
the manufacturers for those who do not have 
access to instruments. 

The sounds are very realistic when 
reproduced at the pitch at which they were 
recorded, but many sounds then have only a 
limited range before becoming either 
unrecognisable or occasionally unpleasant 
sounds. Anulliei featuie that can affect the 
realism of the sound is the change in the 
length of the sound with the pitch. This 
means that sounds can become very short in 
the higher octaves. The present version oi 
the software allows a sound only to be 
allocated to A (ftftOHz). This ran he limiting 
if the pitch of the sound source is not the 
same. 

I found the ability to synchronise to tape 
very useful. The drum kit I was using (Bass 
drum, Snare drum, Open Hi-Hat, Closed 
Hi-Hat, Crash cymbal) filled memory, so when 
I recorded this using a * track Portastudio, 
I recorded the synchronisation track on 
track i*, the drums on track 1. bach channel 
from the D53 was fed to one input on the 
mixer where separate equalisation and 
effects could be applied to each. Then a 



bass sound was sampled, a sequence to fit 
the song developed, and then this was 
recorded on track 2, synchronised to the 
drum track. Although 1 chose not * to use the 
facility, I could then have recorded a 
rhythm sound on track 3, again in synch. 

I did find the software irritating at times. It 
was clearly written as each facility was 
developed, so there was considerable 
inconsistency in the effect of different 
keys. Sometimes a return was npederi after 
selecting an option, sometimes not. In most 
of the program, a control-c invoked a small 
menu that allowed the disk to be catalogued 
or the main menu to be accesed, but not 
always. Sometimes rontrol-r was used for 
another purpose. When the control-c menu is 
accessed, the current drive is not shown, so 
frequently when using a 2 drive system the 
wrong drive was catalogued. More 
importantly, there is no facility to 
initialise a disk from within the program, 
so that a carefully recorded sound could be 
lost if a disk with enough spare is not 
available. This is a consideration when a 
sound may be 130 sectors or more. A further 
problem is the tendency of the program to 
crash for no apparent reason. To be fair, so 
far I have not lust data but on one occasion 
I hit reset after crashing. The program 
appeared to restart, but the DOS had been 
disconnected, so data could not be saved. 

The manual has been written by someone too 
close to the program, and who was using an 
Apple I+, I was using a //e, and found the 
keyboard instructions confusing. There is 
also no Index. 

CONCLUSION 

Once 1 got the hang of the system, I found 
It quire easy to use and very powerful, it 
really is a practical music making system. It 
would be useful to anyone involved in making 
and recording modern music. The hardware is 
to a very high standard, but the software is 
irritating although very powerful. The cost 
of the system is very reasonable, the basic 
unit being L25Q ♦ VAT <with the keyboard 
1^50 ♦ VAT). I am pleased to say that the 
cost includes 2 free software updates. 
Subsequent updates will be available at a 
reasonable charge. 

(I am hoping to buy a system for my own use 
as a result of my experiences). 
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Sorting Reader/' Letter/ 



QUICK AND SHORT SORTS 
by R. C. Lowe 

The most powerful sorting algorithm that I 
know of is the Quicksort. It is usually 
implemented as a recursive routine but here 
is a non recursive version that you may feel 
useful. 

It sorts the array NM(X) which has QN 
numbers In it. 

1 CM = 12: DIM Q!.(QM>,QR(QM) :QS = t i 
IQL(I) = 1 :QR( I ) - QN 

2 QL a QL ( QS ) : OR = OR(QS) = 
OS - QS - I 

3 QI - QLiQJ = QR:QX = 

NM ( INT ( (QL * QR) / 2)) 
U IF NM(QI ) < QX THEN QI = QI | I : 
GOTO t* 

5 IF QX < NM(Q.I) THEN Q3 = Q3 - I : 
GOTO > 

6 IF QI > QJ THEN 9 

7 QW$ = NM(QI):NM(QI> = NM( QJ ) ! 
NM(QJ) = QWS 

8 QI = QI * l:QJ = QJ - 1 

9 IF QI < - QJ THEN 4 

10 IF QI > = QR THEN 12 

1 1 QS = QS + I :QL(QS) = QI : 

QK(QS) - QR 
I 2 QR - QJ ; IF QL < QR THEN 3 
13 IF QS < > THEN 2 
1 «t RETURN 

For a short sort the best I have found is 
this version of the shell-rnetzner sort which 
fits on two lines. It uses NM(X) and QM in 
the same way. 

I QM = I NT (QN / 2 ) : FOR QA = - I 
TO STEP 0! FOR QJ » I TO QN - QMi 
FOR OH - QJ TO STEP - CM:QL = QH 
* QM:QK = 0: IF NM(QH) > NM(QH) 
THEN QZ b NM(QH ) : NM(QH ) - NM<QL): 
NM(QL) = Q2:QK = QH 

? QH = QK: NEXT: NEXT:QM -- lNT'QM/2): 
QA = (QM > 0): NEXT 

Is it possible to have a one line sort? If 
it is I am sure somebody out there has one 
so why not write in to Hardcore and tell 
everybody about it? 



Guisborough, Cleveland. 
Dear Sir, 

1 spoke to Nik Kelly about the BEEB/Apple 
software and he mentioned a 'game port' 
printer link but could not locate the 
article. I wonder if anyone could tell me 
who was involved with this and possibly send 
me the article. 

Could you please let me know of any user 
groups in my area. 

Are there any Wizardry fans, i.e. people who 
wouldn't mind being rung up or ringing, up at 
LOO am for help/advice on 'Legacy of 
LLYYGAMYN' (any fans will know what 1 mean). 

I'm on i$$T JS2$' ■ 

Yours faithfully, 
T. I. Young. 

/Ed. -Dick Pilgrim is trying to set up a 
local group. Contact him at 20 Woodley 
Grove, Ormesby, Middlesbrough./ 

Sunbury-on-Thames, Middlesex. 
Dear Yvette, 

I notice that in Qucntin Rcidford's review 
of "Data Capture U.0" in your February (&it) 
issue, he expresses surprise that there was 
no facility for changing data word 
length...". 

As the owner of an early (1980) cupy of 
"DCAP 4.0/80", I happen to know this is not 
in fact true, though no-one could be blamed 
for missing the point - it's not in the 
documentation, which doesn't even tell you 
what the default values are, but tucked away 
in a "Help File" on my disk is a cryptic 
note headed "Changing Parity and Word 
Length" (that's one way to do it, I 
suppose)! This gives, for the Mirromodem II, 
two addresses into which to poke "X", "the 
value found on page 37 of the Micromodem II 
manual"; and for the Communications Card, 
two addresses into which to poke "X", which 
in this case is not specified at. all! I have 
the AlO Serial/Parallel Card, which appears 
to get the same treatment as the (Apple) 
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Communications Card, and it would seem that 
"X" is a value specified lor the 6850 AC1A 

which both cards use, values for which ate 
tabulated in the AIO manual. 

It's all very sketchy and unsatisfactory, 
but as Quentin said, one doesn't usually 
have to make the change and I never have 
done. It may be (hat the "Help File" on 
later versions may be more explicit - I 
believe Southwestern Software do keep 
improving it. And it's always possible that 
some of our dealers know. 

Yours sincerely, 

R. Teale. 



London Nfi. 

Rc Andy Holdcrncss's ITT 2020 article, 
Hardcore ft/3. 

b> The Videx Softswitch works. 

a) Lower case mod. can be done. 

al) Display: a 2716 EPROM on a piggyback 

board can be used to replace the character 

generator: wc got ours from Lion House long 

ago. 

a2) Shitt Key. A shift key mod compatible 
with the 'standard' Apple I mod can be 
made. For 2020s with (newer) cherry 
keyboard: 

Add the following to the keyboard PCB: 
+5 



to pin 4 of 
keyboard connector 

use any Inverter 
R * lkOhm, say 

this box con La ins 

added components 

On main board, lift pin I ol HI ft (/ftLS251Jj 
connect wire from keyboard connector pin ft 
to the lifted pin. (This will affect ITT 
graphics ninth-bit if graphics mod not 
done). 

The chip added to the keyboard can be 
'piggybacked' onto an existing chip via +5V 
arid ground pins. 

Older (Apple) keyboard: make connection to 
Pin ft of the keyboard connector as descibed 
m Apple literature. 




M »ke Salem (Hilderbay Ltd). 



Swansea. 

Dear Gentlemen, 

I want to ask you about a condition setting 
of EPSON FX-80. 1 am using an Apple //c and 
an Epson FX-SO with Intelligent serial 
interface, because Apple //c has only serial 
interfaces. 

As far as running word processing software 
goes, for example "Appleworks" et al., my 
Epson prints out very well, but it is 
impossible using "Mousepaint" software, 
written by Apple. I think this software's 
printout program is written only for Apple 
Irnagewriter since in the manual there is no 
explanation ot installation «lor Epson FX-80. I 
asked Apple UK but they have no answer. I 
suppose they want to sell their own printer 
so they don't want to teach me. As you know 
the Applepaint software is quite popular. If 
it can't print out on Epson, everyone has to 
buy an Irnagewriter. 

So please can you tell me how to set the 
Epson FX-80 for Mousepaint. For Appleworks I 
use these conditions: S bit, disable parity, 
odd, 9600 baud, 166/ 11 2ft. 

1 thank you in advance. 

T. Murakami. 



Sevenoaks, Kent. 

Dear All, 

Res Macintosh . 

You really must stop everyone talking about 
Apple and differentiate between types of 
Apple; Mac, 2e, 2c, etc. (Ed. Point taken). 

Can wp please get some technical/operating 
hints together tor the Mac. 

1) I have ronlderable trouble with the DOS; 
badly need a DOS listing for error reports; 
ID26, No Memory space for ejecting disk, 
FO??????, etc. when disk appears faulty. Also 
OS does NOT (!) ask/offer to Initialise 
Disk, just ejects and refuses to accept it 
if one lias copied some progs onto it but 
forgot to initialise first! I have sent one 
such to P & P Micro Distributors, a disk 
which machine rejects so I can't erase it or 
anything. 

2) Errors or parts of Mac manual which don't 
operate as described therein:- 
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p.OO - W Not true. One can call for alarm 
and OS will call for another dish which 
appears entirely unrelated (!) AND one can't 
escape or Break irom Alarm option, i.e. forget 
1 asked for it - have to switch off. 

p.tl (4> I can't CUI date from CP into Note 
pad. fMack area of say "DAY" in calendar 
clicked and on attempting to drag all the 
numbers of "DATE", won't have it, so can't 
cut and paste as slated. Then can't get rid 
ol black area around DAY without closing 
whole CP window. 

p.95 Again, the stated iacility that one can 
paste the clock into a doc. doesn't work for 
me; I can't pick up the whole date/time to 
cut into anywhere, only 1 numeral at a time 
will go inverse. 

The other worrying thing is disks renaming 
themselves before/after switchoff and on 
switching on tonight finding clock has lost 
5 mins. I did not inadvertently touch 
keyboard as 1 poke it around the LHS of Mac 
to leave desk front clear. 

Secondly* after almost two months oi owning 
a Mac, 1 am short of: 2nd disk drive - no 
printer buffer on offer(?) - No language, 
except Forth which I really don't want to 
put in front of Basic - No MacMul Utile - No 
MacMultiplan - so I can't get on with even a 
domestic database, let alone some business 
experimentation which is now getting urgent; 
demonstrations by mc of Mac's abilities in 
this sphere tare awaited. 

Thirdly, what news of Macwofks please? I 
believe it's in the offing, but nothing 
definite, like the others above. 

Fourthly, your Intro Disk is fine and 1 see 
the new Rev of Systems disk incorporates the 
very disk copy routine you have on there; 
the copying before that was received was 
chronic, another reason for the exasperation 
over lack of disk dTive 2. 

Fifth, when may we expect to sec a Universal 
modem for the Mac. I would like to get on to 
Prestel and the bulletin boards as soon as 
poss. Perhaps Vicom could be chivvied along 
a bit. 

Sixth, Mac Alarm by Tom Warrick was 
interesting but I had sussed it out without 
too much trouble, watchout it you are 
working in say a Macpaint window with 
Clickart, and you call up the alarm window. My 
Clickart screen froze and 1 could get an 
Edit menu only, till friend Vernon 



Quaintance had a look, cancelled the alarm 
window and the Paint window came alive 
again! For more odd things about alarm clock 
see the current (as at mid-August) Byte, 
p.2'/X They also have an up-to-date review of 
Mac. The request for extraordinary disks by 
OS which appear entirly unrelated to what 
one is currently doing is partly explained 
in Byte. 

A good book in my opinion is the one from 
Microsoft (UK have it) by Gary L« called 
"The Apple Mac Book"; a superb tome and 
worth every penny of 1 19.95. 

Yours sincerely, 

P. Knight, C.fcng. 



Dinas Powis, South Glamorgan. 
Dear Sir, 

1 use an Apple I Europlus to keep medical 
records, accounts, and word processing, 
using two standard Apple disk drives, a .luki 
daisywheel printer and a Sup'r Terminal ISO 
column display. I now have two problems. 

I use PFS as my database for keeping medical 
records and accounts. At first it was fine 
as it is an easy system to use, economical 
with disk space and quite powerful m its 
ability to search the file. 1 have found 
however that now I have several hundred 
records on each disk its sequential approach 
to searches in the absence of indices makes 
finding a record or a series ot records a 
time consuming business. It requires a **0 
column screen, a further disadvantage, and I 
lack flexibility in data management, such as 
the ability to per form a global update, keep 
more than one database on a given disk and 
write from the database to another set of 
records. I find that unless 1 go to CP/M 
there seems to be a dearth of really good 
Apple database software. Can you advise me? 
Your response will be affected by the second 
problem. 

I have an awful lot of data now, mainly text 
in the form of medical records, which must 
be rapidly accessed when a patient comes in. 
Apple disk drives are so limited in their 
capacity that 1 am having to change disks 
all The time. I do noi wish to buy a liar cf 
disk system, not this year anyhow, and 
wonder if there is any way of enabling Apple 
to talk to double sided double density disk 
drives? I suppose this would require a 
change of operating system to CP/M. Do you 
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have any views on mis? Would Omnis, for 
example, using Pascal and therefore 
independent of DOS be .able to address a 
larger floppy disk facility than the 
standard drive? 

I have experience ol dBase It in another 
application on a different machine and quite 
like ii but clearly it has its limitations 
for this type of application and I am unsure 
whether or not Apple using it could addiess 
a larger disk format. I have looked at 
Omnis, which is fine lor my application, but 
seems to be limited to Apple disk format, or 
requires a hard disk. 1 would lie interested 
to know whether it is in use with another, 
target type of floppy. 

What I really would like is a system where 
my word processor c:ould tead the database, 
and vice versa, and both use the SO col. screen, 
a fast and comprehensive database program 
and of course the ability to convert my 
present records to the new system without 

re-entering it by hand! No doubt this 

appears an unattainable ideal but I would 
welcome your views. 

Yours faithfully. 

Dr. A. Peter Smith. 



Welwyn, Herts. 
Deai Mr s. Teo, 

In case no-one else has bothered to write 
in, I think I should let you know that the 
new program AppleWorks will not print on an 
Epson printer with the standard Epson 1832 
interface card. 

The program is designed to print on a 
variety of printers. Ten of the most widely 
used are incorporated in the program and can 
be called up at will. Provision is made for 
an eleventh, the user's own custom primer, 
which he will have to configure himself. The 
Epson MX series is included as standard but, 
when called upon to print, the program 
behaves as though printing is taking place 
but nothing crimes out on pdper. 

My dealer was surprised to hear of this, as 
it works on his own Epson. He then realised 
that he was using a Crappler card and when 
he tever led to the 1832 card he found the 
same problem. Facing Apple UK with the 
situation, they finally admitted that there 
is a bug which ihey are endeavouring to iix 
but cannot suggest any ttmescale. They were 
apparently very reluctant to admit to a 



fault, trying to suggest that there was a 
problem with the hardware. Perhaps BASUG 
would like in have a go at Apple un my 
behalf. 

Yours sincerely, 
Stuart F. wood. 

Reinventing 
the Wheel 

by Yvette Raikes 

Like most people, I have made the mistake of 
programming first and worrying afterwards. It's 
not just a case ol bad documentation but 
often of bad structuring and lack of 
thought. Insufficient planning can cost 
hours of correction. Not giving a few 
minutes of forethought can give days (and 
nights!) of trouble. 

Why bother to tell you this? After all, 
e-veryone does the same. Actually writing the 
code is far more exciting than thinking 
ahoiiT It and you have the satisfaction of 
seeing your efforts in writing. But I have 
finally realised that to save time you must 
spend time and if one person can learn from 
my mistakes then this will be worth writing. 

The first thought tor a program shouid be a 
definition of the problem it is to solve. It's 
surprising how easy it is to lose sight of 
the purpose of the program in the thrill of 
constructing a clever subroutine. Having 
decided on that, you should then give a 
rough outline of what that problem involves. For 
instance, making a cup of tea involves 
filling a kettle, boiling the water, getting 
a clean cup, getting the teapot clean and 
wanned, putting lea in the teapot, followed 
by boiling water and a time delay (while the 
tea brews), putting milk in the cup (if 
desired), pouring out the tea and adding 
sugar and/or lemon (if desired). 

Having established that, it is then easier 
to plan the individual areas ol the problem. It 
becomes obvious, for example, that user 
choice must be allowed at some points, also 
that some choices preclude others, i.e. if 
milk, no lemon. Some stages must be 
completed before the nexr can commence. Others 
can happen at various points. <A clean cup 
can be obtained at any point until the 
choice for put ling milk in arrives. 

This is where the use of a flowchart comes 
into its own to show how each section 
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relates to ail the others. I always hate 
writing flowcharts but find that when they 
are in front of me, 1 use them extensively 
and usually write better programs. A 
flowchart also highlights any area which has 
many entrv and exit point 1 ;, i.e. is 
connected with vvpral other section* of the 
program, which forces you to plan how they 
will interrelate. 

The next stage is to define how each section 
will be constructed. Getting a clean cup 
seems simple but what if there is no clean 
cup? Should this section include giving up? 
Finding a used cup and washing it up? Or 
should there be an option to continue with 
the used cup? Hygiene apart, this is where 
most programs collapse. Error conditions and 
incorrect usage can often blow a program 
simply because the programmer did not cater 

for every case. It is not enough for the 
program to be only able to cope with the 
obvious and the straightforward. It must be 
able to come to a satisfactory conclusion 
even if the problem is left unsolved e.g. if 
a cup can't be found, then the tea won't be 
made. Nevertheless, the program should 
not crash, it should clearly state what 
went wrong and if this means that it has to 
be aborted, it should do so tidily (switch 
of! kettle, etc.). All too olten average 
programs could be good if only error 
conditions were properly coped with. If 
files need closing, they should be closed. Data 
should be saved where necessary. In tact, 
wherever possible, programs should leave 
everything in the best possible condition 
for recovery and further use. 

Having decided how each section should come 
together, it is worth checking whether there 
is duplicate logic in different sections 
which could more conveniently be written in 
a subroutine. Error conditions are a prime 
candidate for this. Disk errors and 
validation checks can occur in several 
different areas. You can often save hours of 
duplication by a few minutes spent here. It 
is irritating to discover that after 
inventing the wheel, you have then 
re-invented it elsewhere. 

At this point it is usually possible to 
start coding, but unless it is really simple 
stuff, it is olten wise to write your 
program away from the machine. It is easier 
to check back through your logic if you can 
lay all your sheets of paper out in front of 
you. It is more difficult when only part of 
the routine is visible on the screen. It can 
also save you hours of retyping in bits of 
code. At the risk of being boring, I cannot 
emphasise too much the need for clear and 



plentiful remarks. It is amazing how quickly 
you can forget what a piece ol coding was 
for. It makes debugging simpler and means 
that anyone else looking at your program has 
a fighting chance ol understanding what is 
going on. I've often been asked to help 
eliminate a bug and taken a lot longer to 
find it than was really necessary simply 
because the code was not self-explanatory 
and there were no comments. This is also a 
good case for using meaningful labels. 

Having (eventually) typed the program into 
the machine section by section, it is always 
worth printing a hard copy if you have the 
facility. It makes debugging a lot easier. You 
should also save your program each time a 
new section is entered so that if anything 
happens, you don't have to retype the entire 
thing. Where possible try testing each 
section separately. If you try the whole lot 
and it doesn't work, there's an awful lot to 
check through whereas if each section is 
debugged and working yon know you have 
problems in the connections between them. You 
should save your program each time you amend 
it and of course, keep a backup copy. If you 
make a great many alterations, a new hard 
copy is advisable. 

Finally testing the program should be an 
exhaustive procedure. Every choice should he 
tried. Invalid data should be entered. You 
should try to make the program fail by every 
method at your disposal, Including putting 
all unlikely combinations together. If you 
can't crash your program, give it to someone 
else to try. If the program still comes out 
tops, then you r ve probably got it right. This 
is the time to make a final hard copy. Rest 
of all, when the program needs updating or 
you want to make a change, it will be simple 
and straightforward because you will have 
all the documentation (you won't have thrown 
it away, will you?) and your program will be 
easily altered. 
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DIARY 



October 

2nd Herts Croup. 8pm. Macintosh demonstration. 

A look dt some of the software. 
3rd tssex Group. 8pm. 

8th Hants & Berks Group. 7.30pm. Databases. 

What are they? Some examples. 

12th Mid-Apple (Birmingham). 8pm. 

15th Croydon Group - Music on Apples, e.g. 7apple. 7pm. 

17th Essex Group. 8pm. 

20th Assembly Lanquaqe Course, County Hall, London. 9am to 5pm. 

f?0 members, 125 non-members. 

November 

6th Herts Group. 8pm. Which DOS? A look at ProDOS, Fast DOS, 

Diversi-DOS, etc. Why not bring your favourite DOS? 
7th Essex Group. 8pm. 

9th Mid-Apple (8irminqham). 8pm. 

12th Hants & Berks Group. 7.30pm. Home servicing and repairs. 

Your faults and preventive maintenance. 
19th Croydon Group - Word Processing packages compared. 7pm. 

21st Essex Group. 8pm. 

22nd - 24th Northern Computer hair, Manchester. 

December 

4th Herts Group. 8pm. Communications - A look al ASCII Express 

and Prestel editing 1n colour on the Apple, 
bth Essex Group. 8pm. 

10th Hants & Berks Group. 7.30pm. 

14th Mid-Apple (Birmingham). 8pm. 

17th Croydon Group - Adventure Games: Philosophy of design. 7pm. 

19th Essex Group, ftpen. 

If you would like your events in the diary, please write in and tell us about 
them. 
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TRADE IN - TRADE UP ! 

TO AN APPLE He, APPLE He OR A MACINTOSH 



OK. SO YOU LIKE YOUR PRESENT APPLE A LOT. 

BIJI , THFKJ- CAN ME MANY ADVANTAGES IN MOVING 

UP TO ONE Of APPLE'S NEW. POWERFUL AND PRACTICAL 

MACHINES IF ONLY THE PROBLEM OF WHAT TO 00 

Wll H YDUH PRESENT MACHINE CAN 8E SOLVED 

WE HAVE THE ANSWER. 

Wt NfcEU SUPPLIES OF APPLE IU AND II* WE WILL LOVINGLY 
CLEAN, POLISH AND RESTORE THEM TO LIKE NEW. BEFORE 
FINDING THEM NEW HOMES SO WE WILL MAKE ALL YOU 
APPLF OWNFHS AIM OFFER, 




NEW APPLE PRICES 

Apple lie Computer £93$ External D.,k Apple lie -£230 
Monitor Apote uc~£ 1*0 Monitor Stand Apple llc-£27 
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I ineoewritvr Printer l5"-£525 
Writer Ate. Kit Mec,r>to,h-C38 
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